Workday | Create an API Client

To access the Time Off data in Workday, you must first create an API Client.

Prerequisites

• You have Admin access to your company’s account.
• You are logged in to Workday with your Admin credentials.
• You have authenticated the ISU and enabled GET and View access in Workday.

Find your Token Endpoint URL

1. In the Search field, type View API Client.

2. Select the View API Clients task. The View API Clients page appears.

3. Save the URL in the Token Endpoint field.

Create a new API Client for Integrations

1. In the Search field, type Register api client for integrations.

2. Select the Register API Client for integrations task. The Register API client for Integrations page appears.

3. In the Client Name field, type the client name.

4. Select the Non-Expiring Refresh Tokens option.

5. In the Scope (Functional Areas) field, select:

   1. Tenant Non-Configurable

   2. Staffing

   3. Time Off and Leave

      

6. Click OK. The client ID and client secret are displayed.

7. Save the Client Secret and Client ID.

8. Click Done

Generate a non-expiring Refresh Token

1. In the Search field, type View API client.
2. Select the View API Clients task. The View API Clients page appears.
3. Click the API Clients for Integrations tab.
4. Click the [New API Client] you just created.

5. Click API Client > Manage Refresh Tokens for Integrations. The Manage Refresh Tokens for Integrations page appears.

6. In the Workday Account field, enter the Workday account of a user who has access to the custom report.

7. Set up the user as a service account instead of an actual Workday user to prevent permissions being removed from the account due to a job change.

8. Click OK.

9. Return to the Workday home page.

10. In the Search field, type Register api client for integration.

11. On the Delete or Regenerate Refresh Token page, select the Generate New Refresh Token option.

12. Click OK.

13. On the Successfully Regenerated Refresh Token Page, copy the refresh token.

14. Click Done.