Steps
-
Log in to Zendesk Admin Center
- In the left sidebar, click Apps and integrations
- Select APIs
- Open the OAuth clients tab
-
Create an OAuth Client
- Click Add OAuth client
- Fill in:
- Client Name: e.g.,
My Integration - Description: (optional)
- Redirect URLs: Your OAuth callback URL
- Client Name: e.g.,
-
Get Client ID and Client Secret
- After saving, Zendesk will generate:
- Client ID (Identifier)
- Client Secret
- Copy and store them securely
- After saving, Zendesk will generate:
-
Configure Redirect URI
- Ensure your callback URL is listed in the OAuth client settings
- No trailing slash, must use
https
-
Understanding Scopes
- Zendesk does not provide a UI to configure scopes in the Admin Center
- Scopes are requested at authorization time as part of the OAuth flow
- Zendesk supports these OAuth scopes:
read— Read access to Zendesk resourceswrite— Create and update resourcesdelete— Delete resources
- Permissions are also constrained by the user’s role (agent, admin, etc.)
Key Details
- Admin Center:
https://{your-subdomain}.zendesk.com/admin - Auth Type: OAuth 2.0
- Authorization URL:
https://{your-subdomain}.zendesk.com/oauth/authorizations/new - Token URL:
https://{your-subdomain}.zendesk.com/oauth/tokens - Base API URL:
https://{your-subdomain}.zendesk.com/api/v2/ - Credentials Location: Admin Center → Apps and integrations → APIs → OAuth clients
- Available Scopes:
read,write,delete - Note: Replace
{your-subdomain}with your Zendesk account subdomain in all URLs