Connecting your Zendesk data is a simple three-step process:
- Retrieve your Zendesk API Token
- Enter your Zendesk credentials into Stitch
- Define the Replication Frequency
Retrieving Your Zendesk API Token
- Sign into your Zendesk account.
- Click the Settings icon in the bottom-left corner of the screen.
- When the Settings menu displays, locate the Channels section. Click the API link in this section.
- In the Token Access section of this page, click the checkbox next to Enabled. A list of Active API Tokens will display.
- Click the Add New Token link.
- When prompted, enter a label for the token. We recommend using 'Stitch,' so you will know, at a glance, what application is using the token. Click Create.
- An API token will be created. Copy this token; it'll be used in the next step.
Here's a look at this part of the process:
Entering the Zendesk Credentials into Stitch
- On the Stitch Dashboard page, click the Add an Integration button.
- Click the Zendesk icon. This will open the Zendesk credentials page.
- Enter a name for the integration. This is the name that will display on the Stitch dashboard for the integration; it’ll also be used to create the schema in your data warehouse.
For example, the name “Stitch Zendesk” would create a schema called
stitch_zendesk in the data warehouse.
- Enter your Zendesk site prefix. For example, if our full Zendesk URL was stitchdata.zendesk.com, we only need to enter the prefix, or stitch, into this field.
- Enter your Zendesk login email and API token.
Defining the Replication Frequency
The Replication Frequency setting determines how often Stitch will attempt to replicate data from Zendesk. By default the Replication Frequency is set to 30 minutes, but you can change the interval to better suit your needs.
You can also update this setting at any time in the Integration Settings page.
When defining the Replication Frequency, keep in mind that:
We recommend giving thoughtful consideration to how you define the Replication Frequency for your Zendesk integrations. This will help prevent burning through your row limit and incurring billing overages.
For more info on reducing your row count, check out our tips and tricks here.
When finished, click the Save Integration button.
If the connection is successful, a Success! message will display at the top of the page. Now you can sit back and relax while Stitch replicates your Zendesk data to your data warehouse.