Manage API keys

Manage API keys

Create an API key

1. Click the cogwheel icon in the top-right corner of the navigation bar.
2. Select Workspace Settings from the menu.
3. Click the API keys tab at the top of the settings page.
4. Click Create API key.
5. In the dialog that opens, enter a descriptive name in the Name field — something that identifies what the key will be used for, such as Zapier integration or Document automation script.
6. Click Create API key.

The key is generated and added to the list. Copy the secret key immediately and store it somewhere secure, such as a password manager or your application's environment variables.

Rename an API key

You can update the name of an existing key at any time — for example, to better reflect what it's currently used for.

1. On the API keys screen, find the key you want to rename.
2. Click Edit to the right of the key.
3. Update the Name field.
4. Click Save changes.

Revoke an API key

If a key is no longer needed or may have been compromised, delete it immediately.

1. On the API keys screen, find the key you want to remove.
2. Click Delete to the right of the key.
3. Confirm the action when prompted.

Any application or script using that key loses access immediately. If the integration is still needed, create a new key and update your application with the new secret.

Keep API keys organised

If you use the API across multiple integrations or environments, give each one its own dedicated key. That way, if one key needs to be revoked — say, when an integration is retired or a contractor's access ends — you can remove just that key without affecting anything else.

For full details on available endpoints, request formats, and response examples, see the API reference.