Skip to main content
Back to Actions Integrations Connect Zendesk to create, view, update, search, and delete tickets. See Zendesk Developer Documentation for more information.

Authorizations Supported

The XO Platform supports basic authentication for Zendesk. See App Authorization Overview for details.
Authorization TypeBasic OAuth
Pre-authorize the IntegrationYes
Allow Users to Authorize the IntegrationYes

Step 1: Enable the Zendesk Action

Prerequisites:
  • If you don’t have Zendesk credentials, create a developer account. See Zendesk Developer Documentation.
  • Copy the User sub domain, username/email, password, and API token of your Zendesk account.
Steps:
  1. Go to App Settings > Integrations > Actions.
  2. Select Zendesk.

Pre-authorize the Integration

Basic OAuth
  1. Go to App Settings > Integrations > Actions and select Zendesk.
  2. In Configurations, select the Authorization tab.
  3. Set Authorization Type to Pre-authorize the Integration > Basic Auth. Auth type - Basic auth
  4. Enter the following details:
    • User Sub Domain – The instance name of the Zendesk account.
    • Username or Email – The username or email of the Zendesk account.
    You must enter /token after the email address to authenticate. For example, john@example.com/token.
    • API Token – The password token of the Zendesk account.
    Details to authorize the integration
  5. Click Save. The Integration Successful pop-up is displayed. Integration successful
    The Zendesk action moves from Available to Configured after enabling.
  6. You can also click Skip for Now to install templates later. See Using the Zendesk Action Templates. Skip for now

Allow End User to Authorize

  1. Go to App Settings > Integrations > Actions and select Zendesk.
  2. In Configurations, select the Authorization tab.
  3. Select Basic Auth as the authorization type. See App Authorization Overview.
  4. Click Select Authorization > Create New. Create new auth
  5. Set Authorization Type to Allow Users to Authorize the Integration > Basic Auth, then enter the following credentials:
    • Name – Name for the Basic Auth profile.
    • Base URL – Base tenant URL for the Zendesk instance.
    • Authorization Check URL – Authorization check URL for your Zendesk instance.
    • Description – Description of the profile.
    Authentication credentials
  6. Click Save Auth.
  7. Select the new Authorization Profile.
  8. Click Save.

Step 2: Install the Zendesk Action Templates

  1. On the Integration Successful dialog, click Explore Templates. Explore templates
  2. Click Install to begin installation. Begin installation
  3. Once installed, click Go to Dialog. A dialog task for each template is auto-created. Dialog tasks for each installed template are auto-created
  4. Select the desired dialog task and click Proceed. Select the desired dialog task from the templates and Proceed
  5. The dialog task is auto-created and the canvas opens with all required entity nodes, service nodes, and message scripts. Dialog task is auto-created and the canvas opens