The Zendesk + Iterable integration lets you send data from Iterable to Zendesk, and from Zendesk to Iterable. For example, you could use this integration to:
- Use Zendesk data to trigger an Iterable campaign
- Use an Iterable journey webhook to call a Zendesk API
In this article
Sending data from Zendesk to Iterable
You must have Zendesk admin access to set up this integration. Reference this Zendesk support doc for further help setting up the webhook in Zendesk.
Step 1: In Iterable, create an API key
First, you'll need to create an API key.
Step 2: In Zendesk, create a webhook
NOTE
- This example demonstrates how to create a Zendesk webhook that will post an event to
Iterable's
POST /api/events/track
API endpoint. - Alternatively, you can update a contact's Iterable profile profile. To do this,
map the webhook (or "URL Target", as Zendesk refers to it) to the
POST /api/users/update
endpoint.
In the Zendesk Admin Center, click Apps and integrations (in the sidebar). Then, in the Webhooks section, click Webhooks.
-
On the Webhooks tab, click Create Webhook. You'll see this page:
-
For the Endpoint URL, enter:
https://api.iterable.com/api/events/track?apiKey=<YOUR_API_KEY>
For Request method, choose POST.
For Request format, choose JSON.
For Authentication, select None.
Test your webhook, configuring its JSON body to match the payload expected by Iterable's
POST /api/events/track
endpoint. Before proceeding, make sure that your test returns a200
(successful) response.Click Create.
-
To add your webhook to a support trigger or automation, follow Zendesk's instructions:
For example, here we've assigned the webhook to an Action that's triggered each time a ticket is created, using Zendesk placeholder values to configure its JSON body in the format expected by Iterable's
POST /api/events/track
endpoint:From here, click Save to return to the webhook configuration screen.
On the webhook configuration screen, click Complete setup.
Your automated webhook, sending data from Zendesk to Iterable, is now set up. You can use events sent from Zendesk to trigger campaigns in Iterable.
Sending data from Iterable to Zendesk (using journey webhooks)
To send data from Iterable to Zendesk, you can use a journey webhook. Follow these steps:
-
In Iterable, create a new journey webhook:
Navigate to Integrations > Journey Webhooks.
-
Clicking New Webhook, which brings up the Create journey webhook page:
Give the webhook a Name.
For Destination, choose Custom.
For Method, select POST.
-
For Endpoint, enter the URL of the Zendesk API you'd like the webhook to call. For example, to create a new user:
https://<YOUR_ZENDESK_ORG>.zendesk.com/api/v2/users/create_or_update.json
For a list of endpoints, see Zendesk's API docs.
If the webhook's endpoint requires authentication, set up Basic authentication or custom HTTP headers. To learn more, see Zendesk's support guide, How can I authenticate API requests?.
For Body, select JSON. Then, configure the webhook to send the data that Zendesk expects. For more information, see Zendesk's API docs.
Click Create webhook.
Add this webhook to any of your journeys to begin sending data to Zendesk.
Comments
0 comments
Please sign in to leave a comment.