What’s Supported

Supported Actions

The Zendesk Support connector supports:

  • Read Actions, including full historic backfill. Please note that incremental read is not supported, a full read of the Zendesk Support instance will be done for each scheduled read.
  • Write Actions.
  • Proxy Actions, using the base URL https://{{.workspace}}.zendesk.com.

Supported Objects

The Zendesk Support connector supports reading from and writing to the following 48 objects:

Example Integration

For an example manifest file of a Zendesk Support integration, visit our samples repo on Github.

Before You Get Started

To integrate Zendesk with Ampersand, you need to Create a Zendesk Account and obtain the following credentials from your Zendesk App:

  • Client ID/Unique identifier
  • Client Secret

You will then use these credentials to connect your application to Ampersand.

Create a Zendesk Account

You need a Zendesk account to connect with Ampersand.

Creating a Zendesk App

  1. Log in to Your Zendesk Account.

  2. Go to Admin Center.

  3. On the Admin Center page, click Apps and integrations.

  4. Under the APIs heading in the left navbar, click on “Zendesk API”.

  5. Click on OAuth Clients tab.

  6. On the OAuth Clients page, click Add OAuth client.

  1. On the Add OAuth client form, enter the following details:

    1. Client name: The name of the OAuth client that will be shown to your users in the OAuth popup.
    2. Unique identifier: Ensure that you enter a name that is prefixed with zdg-, this allows you to request a global OAuth client later. This identifier is also what you will enter in the Provider Apps tab of the Ampersand dashboard in the next step.
    3. Client kind: Select “Confidential”
    4. Redirect URLs: Enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth
  2. Click Save.

Add Zendesk App Details in Ampersand

  1. Log in to your Ampersand Dashboard.

  2. Select the project where you want to add the Zendesk App.

  3. Navigate to the Provider Apps section.

  4. Select Zendesk from the Provider list.

  5. Enter the previously obtained Unique identifier in the Client ID field and the Client Secret in the Client Secret field. For a list of valid scopes, refer to the Zendesk documentation. Enter each scope in a separate line.

  6. Click Save Changes.

Using the connector

To start integrating with Zendesk Support:

Launch your Zendesk app to production

In order to connect to your customer’s Zendesk instances, you will need to request a global OAuth client. Please note that once you complete this process, you will need to reach out to the Zendesk team in order to edit your app (e.g. adding new scopes, modifying name).