---
category: [Homepages & Self-Service Sites, Platform and Product Extensions, Platform and Product Extensions/Home Experience, Administration & Integrations, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: [Extend, Orchestration, Orchestration Builder]
nav: wcp_docs
parent_url: /wcp_docs/
title: >- 
  Example: Call Third-Party API In Workday Home Card Orchestration
layout: subsection
---

These examples illustrate how to set up an orchestration that displays data on a custom Workday Home card using the Workday API and the third-party Peakon API.

### Scenario

<a id="context_N10024_N1001E_N10001"></a>
You want managers to view their team Peakon engagement score on their Workday Home page at the beginning of each month. You also want to link to the Peakon Dashboard so that managers can analyze their team engagement score in greater detail.

<b>Note:</b> You must be a Peakon customer and have access to the Peakon API to complete this example.

### Steps

1.  <a id="step_N10053_N10050_N10042_N10001"></a>On your application page, click <b>+ Add Orchestration</b>.
2.  <a id="step_N10060_N10050_N10042_N10001"></a>Enter <i>PeakonEngagementScore</i> in the <b>Name</b> field and click <b>Continue</b>.
3.  <a id="step_N1007E_N10050_N10042_N10001"></a>Select <b>Workday Home Card</b> and click <b>Create Orchestration</b>.
4.  <a id="step_N10074_N1002C_N1001E_N10001"></a>Click the gear icon to access the <b>Settings</b> page.
5.  <a id="step_N1009D_N10057_N10042_N10001"></a>Click the <b>Credentials</b> tab and enter or select these values.

<table><thead><tr><th>    Option</th><th>    Description</th></tr></thead><tbody><tr><td><b>Credential Name</b></td><td><i>peakonAPI</i></td></tr><tr><td><b>Type</b></td><td><b>API Key</b></td></tr><tr><td><b>Key</b></td><td><i>Authorization</i></td></tr><tr><td><b>Value</b></td><td>Your Peakon JWT authorization token.</td></tr><tr><td><b>Append to</b></td><td><b>Header</b></td></tr></tbody></table><br/>

6.  <a id="step_N1007A_N10038_N10028_N10001"></a>Get and create Workday employee data values.

    See [Example: Get And Create Workday Employee Data](/wcp_docs/mxj1630014392721.html).

7.  <a id="step_N1008B_N10038_N10028_N10001"></a>If the employee is a manager, continue the orchestration. Otherwise, end the orchestration.

    See [Example: Branch On Manager Condition](/wcp_docs/ugp1630014423871.html).

8.  <a id="step_N1009C_N10038_N10028_N10001"></a>Get and create Peakon data for the manager.

    See [Example: Get And Create Peakon Data](/wcp_docs/otq1630014471293.html).

9.  <a id="step_N100AD_N10038_N10028_N10001"></a>If the manager's team has an engagement score, create values for the score. Otherwise, end the orchestration.

    See [Example: Branch On Engagement Score Status](/wcp_docs/tle1630014572668.html).

10. <a id="step_N100BE_N10038_N10028_N10001"></a>On the <b>Select Card to Return</b> step, click <b>Edit Card Properties</b>.
    1.  Select <b>6 hours</b> as the <b>Duration to Cache Response</b>.
    2.  On the <b>Card Data to Send Back</b> field, click the <b>+</b> icon and select <b>BRANCH ON CONDITIONS</b> &gt; <b>json</b>.
    3.  Click <b>Save Changes</b>, then click <b>Close</b>.

11. <a id="step_N10110_N10038_N10028_N10001"></a>Validate and save your orchestration.


### Next Steps

<a id="postreq_N102A1_N1001E_N10001"></a>
Deploy the app to your tenant and access the <b>Create External Card</b> task in Workday to enable managers to view the Peakon Manager Engagement Score card.

### Related Information

[Administrator Guide: Steps: Create External Home Page Cards](https://doc.workday.com/access/sources/dita/topic?wd:docset=adminguide&ft:locale=en-US&resourceid=fvk1594675953379)