Skip to main content

Update Workday credentials

Use these steps to change the credentials Assembled uses to connect to Workday: the integration system user's password and, if you use the Workday REST API, its API credentials. You keep your existing Workday configuration in Assembled and only update the credentials.

If you're here because of the November 13, 2026 security incident: Workday wasn't one of the integrations Assembled revoked, but please replace its credentials as a precaution. For more about the incident, see November 13, 2026 security incident.

Who does this

  • An Assembled admin, or someone with a role that can configure third-party integrations.
  • A Workday admin who manages the integration system user Assembled connects with.

Before you start

  • Check whether your Workday connection uses report URLs only, or also the Workday REST API. If you didn't set up the REST API before, you don't need to set it up now.
  • Keep your current report URLs and mappings. You'll leave them as they are.

Steps

  1. In Workday, change the password for the integration system user Assembled connects with. If you use the Workday REST API, also rotate its API client credentials and revoke the old refresh token.
  2. In Assembled, go to Configure > Third-party integrations and open your existing Workday configuration. Don't remove the integration.

    The Workday card on Third-party integrations with the Configure integration button

  3. Under Integration system user credentials, enter the updated username and password. Leave your Employee map, Time off report, and any Leave of absence report URLs as they are. Select Continue.

    Step 1 of Connect Workday, with the integration system user credentials and the report URL fields

  4. If you use the Workday REST API, update the OAuth client ID, OAuth client secret, token URL, refresh token, and REST base URL as needed, keeping your other settings the same. Continue through the mappings and select Save changes.

    Step 2 of Connect Workday, with the options for where team members request time off and the Workday REST API fields

  5. Check that new time off requests are syncing.

How to confirm it's working

  • Check that new time off from Workday appears in Schedule > Time off.
  • If the Workday card shows an authorization error, contact Support. Don't rebuild your mappings to fix a credential error.

When you'll see data

Assembled reads time off from Workday every 2 minutes, and leave of absence and balances every 15 minutes. Matching new or changed people can take up to 24 hours.

Restoring missed data

Updating credentials doesn't start a backfill. If time off is missing from while Workday couldn't connect, contact Support with the dates affected and we'll help reconcile it.

Things to watch for

  • Change the password and the API credentials. If you use the REST API, changing only the password leaves the old API credentials working.
  • Keep your report URLs and mappings. Only change the credential fields.
  • Don't set up the REST API just for this. If your connection only uses report URLs, keep it that way.
  • Contact Support for authorization errors. Rebuilding mappings won't fix a credential problem.

For more about how the integration works, see Workday integration.

Need help?

If something doesn't look right, contact our Support team and include any error text you see on the Workday card. Please don't send passwords or secrets by email or chat.

Still have questions?