API Credentials

View as Markdown

Create an API Credential

2

Click Create

Click Create to start the credential creation process.

Create credential

3

Configure your credential

Provide a Credential Name and choose a Credential Type:

Credential types

Credentials Best Practices
  • Credentials are never written to disk or stored in any way. They can only be viewed in plain text once on the Credentials screen. Only the hash of the credential is stored.
  • When an account is deactivated or deleted, any associated API keys will stop working.
  • Moveworks recommends generating API keys using a dedicated service account rather than an individual employee’s user account. Using a service account enhances security by creating a stable, auditable identity for the integration that is not tied to a person’s employment status.

Token Expiry Details

Token TypeExpiry
Client IDs, Client Secrets, & API KeysNever expire
Access TokensEvery 60 seconds

Rotation & Revocation

In the event that your credential is exposed or leaked, follow this process for token rotation:

1

Create a new credential

Create a new API key following the steps outlined above.

2

Update your integrations

Update your code or integrations to use the new API key.

3

Delete the old credential

Use the trash icon to delete the previous API key. Selecting delete will permanently invalidate the key.

Delete credential