Adding Zendesk credentials to Oomnitza

Add OAuth 2.0 client credentials to Oomnitza to sync Oomnitza with Zendesk.

Zendesk announced on June 1, 2026 that it is removing support for API tokens— basic authentication— in phases. See Announcing the removal of API tokens as an authentication method for API requests. 

For all new integrations, OAuth 2.0 authentication must be used in Oomnitza. 

This applies to:

• The extended integration for Zendesk users
• The service desk integration for Zendesk

If you edit an Oomnitza integration for Zendesk users that was previously created using basic authentication, you must switch to OAuth 2.0 client credentials.

For Zendesk user integrations, this means that you must create a new integration — Zendesk User Load (OAuth2)— and remove the basic auth integration. See Creating an extended integration for Zendesk users.

For service desk integrations for Zendesk, you must:

1. Create and add OAuth 2.0 client credentials to Oomnitza.
2. Edit the service desk integration for Zendesk.
3. Select the OAuth 2.0 client credentials that you created or create new OAuth 2.0 client credentials.
4. Save your changes.

See Creating a service desk integration for Zendesk assets.

---

OAuth 2.0 client credentials 

To add OAuth client credentials in Oomnitza, you must generate a client ID and secret in Zendesk. To find out how to do this, review the following Zendesk article: Creating and using OAuth access tokens with the API.

You will need the following information to set this up:

Redirect URL for Oomnitza: https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url

The Client Kind must be set to Confidential.

The following scope must be added users:read for retrieving user data. To retrieve user role information using the SaaS User Role Retrieval workflow block, you need read permissions. To create workflows that use presets, you need read write permissions. See Scope.

Adding the OAuth 2.0 client credentials to Oomnitza

To add the credentials to Oomnitza, you will require the following information:

Figure: Adding OAuth 2.0 client credentials for the extended user integration for Zendesk 

• Client ID and client secret you generated in Zendesk. 

• Subdomain. If your Zendesk URL is https://mycompany.zendesk.comyour subdomain is mycompany.

• Scopes. At least users:read. See scopes above.

The name of the credentials is Zendesk User Load (oAuth2). 

Make life easier and add your credentials to Oomnitza before you create the integration.  

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration.
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.