Config

You must enter the following credentials when configuring this source:

KeyDescriptionSample value
access_tokenOAuth token to access API endpoints.abc123...
request_timeoutNumber of milliseconds until the API request should timeout and raise an error.300
start_dateFetch data that is newer than the start_date.2022-01-01T00:00:00Z
subdomainIf you access Zendesk from a URL like this https://magesupport.zendesk.com/, then the domain is magesupport.magesupport

How to get your access_token

Follow Zendesk’s documentation to get your access token.

Example Admin Center URL: https://magesupport.zendesk.com/admin/home (subdomain in example is magesupport).

Example values for getting access token

Zendesk authorization page

https://magesupport.zendesk.com/oauth/authorizations/new?client_id=mage-ai&response_type=code&redirect_uri=https://www.mage.ai&scope=read

Authorize redirect URL with code

https://www.mage.ai/?code=6b21972c79e12cbda37947df4ba22d4cb394da752e955c6dac81361d5f453695

Example cURL command to exchange code for access token
curl --request POST \
  --url https://magesupport.zendesk.com/oauth/tokens \
  --header 'Content-Type: application/json' \
  --data '{
  "grant_type": "authorization_code",
  "code": "6b21972c79e12cbda37947df4ba22d4cb394da752e955c6dac81361d5f453695",
  "client_id": "mage-ai",
  "client_secret": "your_oauth_client_secret",
  "redirect_uri": "https://www.mage.ai",
  "scope": "read"
}'
Example OAuth token exchange response
{
  "access_token": "cdaae5613efca304972cd8175adf51b560691f51e9a6331a986a772801a5d898",
  "token_type": "bearer",
  "scope": "read"
}