Zendesk

Setting Up Your Zendesk OAuth Application

Zendesk requires you to create your own OAuth application (BYOC - Bring Your Own Credentials) to connect with Graffo. Follow these steps to set up your OAuth client:

Step 1: Create OAuth Client in Zendesk

  1. Log into your Zendesk Admin Center

  2. Navigate to Apps and integrationsAPIsOAuth clients

  3. Click Add OAuth client on the right side

Step 2: Configure OAuth Client

Fill out the OAuth client form with the following details:

Step 3: Save and Generate Secret

  1. Click Save

  2. After saving, a Secret field will appear with your client secret

  3. Copy the entire secret immediately - it will only be shown once in full

  4. Click Save again to finalize

Step 4: Activate the OAuth Client

  1. Find your OAuth client in the OAuth clients list

  2. Change the Status from Inactive to Active

  3. Save the changes

Step 5: Configure in Graffo

When creating a Zendesk connection in Graffo, you'll need to provide:

  1. Subdomain: Your Zendesk subdomain only (e.g., mycompany NOT mycompany.zendesk.com)

  2. Client ID: The identifier you set in Step 2

  3. Client Secret: The secret you copied in Step 3

Troubleshooting

Required Scopes

Graffo requires the following Zendesk OAuth scopes:

  • read - Read access to tickets, users, organizations, and comments

  • write - Write access for updating ticket data (optional, for future features)

These scopes are automatically included in the authorization request.

Last updated