---
title: "Workday integration"
canonical: "https://support.appfire.com/space/DLP/2211187500/Workday%20integration"
format: markdown
---
> Macro (aura-html)

> 📝 Integration with Workday is a [BigPicture Enterprise](https://marketplace.atlassian.com/apps/1215158/bigpicture-enterprise?tab=overview&hosting=cloud) feature available for:
> 📝 
> 📝 - Jira Cloud
> 📝 - Jira Data Center
> 📝 
> 📝 Before you continue, make sure [BigPicture Enterprise](https://marketplace.atlassian.com/apps/1215158/bigpicture-enterprise?tab=overview&hosting=cloud) is installed.

Integrating BigPicture with Workday allows for automated synchronization of employee absences, ensuring that project timelines are always up to date. 

## Integrate BigPicture with Workday

After integration, Workday data becomes the primary source of absences. Resources are matched based on their work email in both Atlassian and Workday. Absences need to be approved in Workday to be reflected in BigPicture. 

### Full integration

When all resources are managed in Workday, integration with Workday fully replaces BigPicture absences. Once the integration is active, manual adjustments in BigPicture are disabled to prevent inconsistencies.

### Partial integration

If some resources are not in Workday, you can still manage their data manually in BigPicture. Partial integration lets you be flexible in resource management across systems. Users who are in Workday are mapped with BigPicture by their email addresses.

### Step-by-step instructions

To integrate BigPicture with Workday:

1. You need to configure Workday integration.
  1. Go to **App Configuration **>** Integrations **>** Workday**.
  2. To get your Workday credentials, follow the steps described in the **Configure REST API in Workday** section below.
  3. Once you completed the steps in the **Configure REST API in Workday** section below and have all the credentials, provide:
    1. **Client ID**
    2. **Client Secret **
    3. **Refresh Token**
    4. **Workday REST API Endpoint**
    5. **Token Endpoint**
  4. Specify a start date for the **Start sync with Workday from** field. From that date onward, BigPicture absences will be replaced, and Workday data will become the primary source of absences.
  5. When ready, click **Save**.

## Configure REST API in Workday

### Register API client for integrations

You need to be a Workday administrator to complete the following steps: 

1. Search for **Register API Client for Integrations** in Workday's search field.
2. Select the **Register API Client for Integrations** task to access the registration page.
3. Enter a name for your API client in the **Client Name** field.
4. Select the **Non-Expiring Refresh Tokens** option.
5. Select **Scope (Functional Areas)**.
6. Click **OK** to generate the Client ID and Client Secret.
7. Save the **Client Secret** and **Client ID**.
8. When saved, click **Done**.
9. Navigate to the **API Clients for Integrations** tab.
10. Select the **API client** you registered in the previous steps.
11. Click the **… More actions** menu next to the client name and go to **API Client **>** Manage Refresh Tokens for Integrations**.
12. Use your existing **Integration System User (ISU) account** or create a new one for the integration. When ready, click **OK**.
13. Select the **Generate New Refresh Token** option and click **OK**.
14. Copy the **Refresh token** from the **Successfully Regenerated Refresh Token** page.
15. Click **Done** to complete the process. After completing the steps above, you should have the Client ID, Client Secret, and Refresh Token.

### Get Workday REST API endpoint

> ℹ️ To understand where the API endpoints come from, refer to the [Workday REST API](https://doc.workday.com/admin-guide/en-us/integrations/workday-rest-api/rest-api-fundamentals/dan1370797985682.html) page.

 The Workday REST API base path format is: 

`https://{tenantHostname}/api/{serviceName}/{version}/{tenant}`

**How to determine your tenant’s REST API path:**

**{tenantHostname}**

- The hostname of the Workday REST web service. You can use the **View API Clients** task to get the hostname.

*Example*: If the **Workday REST API Endpoint** on **View API Clients** displays `https://services1.myworkday.com/ccx/api/v1/gms `the hostname is `services1.myworkday.com`.

**{serviceName}**

- The name of the Workday REST web service. You can find the service names in the <u>[Workday REST Services Directory](https://community.workday.com/sites/default/files/file-hosting/restapi/index.html#absenceManagement/v1/get-/workers)</u>.

**{version}**

- The version of the Workday REST web service. You can find the service versions in the <u>[Workday REST Services Directory](https://community.workday.com/sites/default/files/file-hosting/restapi/index.html#absenceManagement/v1/get-/workers)</u>.

**{tenant}**

- The name of your tenant.

#### Workday REST API for time off details

1. Go to the **Workday REST Services Directory** and find the path for absence details.
2. This example will use the path: `/workers/{ID}/timeOffDetails`
3. Add the above path to your tenant’s API endpoint. It should look similar to: `https://services1.myworkday.com/ccx/api/absenceManagement/v1/gma/workers/{ID}/timeOffDetails`
4. Use an API platform (e.g. Postman) to retrieve the access token.
5. Use the access token to GET REST API time off details.

## Synchronization rules

Synchronization takes place automatically once a day. 

If you want to manually synchronize data:

1. Go to **BigPicture Administration **>** Resources **>** Individuals**.
2. Click the **Synchronize with Workday** button.
3. The synchronization is in progress. You will be informed when the process is completed.

## Remove Workday integration

To remove Workday integration:

1. Go to **App Configuration **>** Integrations **>** Workday**.
2. Click **Remove integration** at the bottom of the page.
3. When you remove Workday integration, the absences already synchronized will remain in BigPicture, so none of your data will be lost. However, the integration will be removed, and new data will no longer be synchronized.
4. To confirm, click **Remove**.

## Absences management in BigPicture

> ℹ️ After integration with Workday, you **can’t** manually add absences for users managed by Workday in BigPicture. If a user **isn’t** managed in Workday, you can still manually manage their absences in BigPicture.

The **Add absence** button is disabled on:

- **My settings **>** Absences**
- **BigPicture Administration **>** Resources **>** Individuals **>** Resource’s page**
- **Resources module **>** Right-click on a task **>** Add absence**
- **Resources module **>** Right-click on an individual **>** Add absence**