Understanding the differences between API tokens and OAuth access tokens

Both API tokens and OAuth access tokens let you authenticate Zendesk API requests without providing your Zendesk password. However, the token types support different creation methods and permission setups.

For server-to-server communications where a broad permission set is appropriate, API tokens might be sufficient and easier to manage. For applications needing to act on behalf of specific users, OAuth tokens provide a more secure and targeted approach.

The following table describes some key differences between API tokens and OAuth access tokens.

DifferenceAPI tokensOAuth access tokens
Creation and managementCreated and managed using Admin Center. See Generating a new API token in Zendesk help.Created and managed using Zendesk API requests.

However, you can create OAuth clients using Admin Center. See Registering your application with Zendesk in Zendesk help.
User associationNot associated with a specific Zendesk user.

However, you must provide an email address for an admin, agent, or other valid user when authenticating requests.
Associated with a specific Zendesk user.
PermissionsPermissions are limited by the user role associated with the provided email address. This means the scope of what the token can access or change is limited by what the associated user is permitted to do within Zendesk.Permissions are limited using scopes and the associated user's role.
Cross-origin resource sharing (CORS) requestsDoesn't support client-side CORS requests.Supports client-side CORS requests. See Making cross-origin, browser-side API requests.

For more information, see Security and authentication.