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 integrations → APIs → OAuth 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.