Skip to main content

Zendesk connection

Learn how to connect with Zendesk

Actioner connects with Zendesk through OAuth2, API key and Basic Authentication options.

Add a new Zendesk connection​

If your app contains a Zendesk connection, you can skip this step and proceed to authentication with your credentials.

To add a new connection, go to App settings tab of your app and click + Add new connection. Select Zendesk (OAuth2), Zendesk (API) or Zendesk (Basic) option and enter a name.

Add new Zendesk connection

Note

You have to be an app admin to add a new connection to your app.

OAuth2 authentication with Zendesk​

To authenticate in Zendesk with OAuth2

  1. Click Connect near the Zendesk connection. You can find the connection on Description tab of your app.
Info

If you are an app admin, you can also update connection properties and complete authentication on App settings tab of your app.

  1. Enter your Zendesk subdomain name on the opening screen. You'll be directed to authorize Actioner in a new tab.

  2. You will be asked to sign in to your Zendesk account if you haven't already.

  3. Click Authorize Actioner to grant permission to Actioner. You’ll be redirected to Actioner upon successful authorization.

API key authentication with Zendesk​

To authenticate with Zendesk API via an API Token

  1. Go to Zendesk Admin Center > Apps and integrations in the sidebar > select APIs > Zendesk API.

  2. On Settings tab, and make sure Token Access is enabled.

  3. Next, click Add API token to generate a new API key and copy it.

  4. Click Connect near the Zendesk connection. You can find the connection on Description tab of your app.

Info

If you are an app admin, you can also update connection properties and complete authentication on App settings tab of your app.

  1. Enter your Zendesk subdomain name on the opening screen.

  2. Enter your Zendesk login in username field and the copied API key in API token field.

Basic Authentication with Zendesk​

To connect with Zendesk API through Basic Authentication

  1. Go to Zendesk Admin Center > Apps and integrations in the sidebar > select APIs > Zendesk API.

  2. On Settings tab, and make sure Password Access is enabled.

  3. Click Connect near the Zendesk connection. You can find the connection on Description tab of your app.

Info

If you are an app admin, you can also update connection properties and complete authentication on App settings tab of your app.

  1. Enter your Zendesk subdomain name.

  2. Enter your Zendesk login email and password.

Sharing scope​

If you are an app admin, you can enable Shared credentials option if you want all users to run actions with the credentials you entered. When disabled, to execute requests and actions, each user completes authentication with their credentials.

Note

You need to Reconnect after enabling or disabling Shared credentials.

Reconnecting​

If your Zendesk subdomain or credentials change, you can reconnect Actioner with Zendesk.

Find the connection on Description tab of your app, click ... ellipsis and select Reconnect. Enter your credentials and complete authorization on the opening screen.

Info

If you are an app admin, you can also reconnect on App settings tab of your app.