Add Your Next Token or Update an Expired Token

Talent Management generates an error when a token is expired. Follow the steps below to add your next token prior to the active token's expiration, or to update an expired token.

About Tokens and the API Self Service Portal
  • To enhance security and improve token management, we provide a single master token per client site for all API usage. You generate this token the first time you access API Self Service.
  • You must be a member of the Configurator group to access the API Self Service portal on the Integrations Setup screen (Administration » Support Tools » Integrations Setup).

About Expired Tokens

  • Expired Master Tokens:
    • When Do They Expire? Your master token expires by the Expire Date saved when the token was created on the API Self Service screen (by default in 6 months (182 days).
    • Will I Be Notified? The user saved in the Notification Email field will receive notifications on a cadence of 7 days before expiration, 3 days before expiration, 30 days after expiration (for six months), every six months after that. Clients who refresh their tokens within one month of the expiration date will still receive scheduled expiration notifications.
    • Update Before Expiration to Avoid Errors: Be sure to follow the steps below to add your next token before this expiration date to ensure users don't receive an error when logging in to Talent Management.
  • Expired Legacy Tokens:
    • When Do They Expire? Your legacy tokens expire by default at 6 months (182 days) after the release date.
    • Will I Be Notified? Your legacy contact person receives notifications on a cadence of 7 days before expiration, 3 days before expiration, 30 days after expiration (for six months), every six months after that.
    • Update Before Expiration to Avoid Errors: In general all legacy tokens should be updated to the new Master Token. Be sure to follow the steps below to add your Master Token before your legacy tokens expiration date(s) to ensure users don't receive an error when logging in to Talent Management.

About the Token Refresh (Change Link)

  • Clicking Change for the API Token field allows you to generate a new master token, pick an effective date, and apply token options.
  • The link is disabled for 6 hours after the token is refreshed.

Refer to the Talent SOA Documentation for additional information.

To add your next active token or to update an expired token:

  1. Click Administration > Support Tools > Integration Setup.
  2. Click API Self Service.
  3. For the API Token, click Change.
  4. Enter the date this new token will become effective. You cannot use today's date. When finished, click Save.
    A Next API Token row is added to the table with the new token. If users are experiencing errors due to an expired token, the errors will stop on the date this token becomes active.