Zendesk Connector

What does the Zendesk Connector app do?

The Zendesk Connector app can import new and historic ticket events to PostHog. However, only the Date Type User Field is currently supported.

What are the requirements for this app?

The Zendesk Connector requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

You'll also need a Zendesk account, with admin access.

Are there any limitations?

The ZenDesk API has a limit of 400hits/min. If you have higher ingestion than that, please contact Zendesk.

How do I install the Zendesk Connector app?

Make sure to use your Zendesk Admin Account to perform the below activities.

Head Over to Zendesk's Admin section -> Settings -> Account.
In the Branding section, scroll down to Subdomain and find your subdomain there.
Head to the Admin Section -> Channels -> API.
In Settings, follow the below steps:
- Turn On Token Access.
- Click on Add API Token.
- Give it some name like PostHog.
- Copy the Token(You won't be able to see it later).
- Save the Token.

Next, Head to the Admin section -> Manage -> User Fields. Click Add Fields and follow the steps below.

Give Name
Select Type Date.
Add field key, (you will be required to share this key in PostHog while setting up)
Click Save.

Configuration

Option	Description
`Host name` Type: string Required: True	Generally, Your Zendesk URL has two parts: a subdomain name you chose when you set up your account, followed by zendesk.com (for example: mycompany.zendesk.com). Please share the subdomain name with us so we can set up your account.
`Host Email` Type: string Required: True	Enter the email for admin of your Zendesk account.
`API token` Type: string Required: True	Enter your Zendesk API Token
`Triggering events` Type: string Required: True	A comma-separated list of PostHog events you want to trigger Profile Updation in Zendesk. For example, if you want to trigger Zendesk Profile Updation on 'pageview' and 'track' events, you can set this to 'pageview,track'. Make sure you have these events enabled in your Zendesk account.
`Email domains to skip` Type: string Required: False	A comma-separated list of email domains to ignore and not update for in Zendesk.

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for the Zendesk Connector is available on GitHub.

Who created this app?

This app was created by the community. We'd like to thank Sandeep Guptan and Himanshu Garg for creating the Zendesk connector, as well as for all the other support and feedback. Thank you, both!

Who maintains this app?

This app is maintained by the community. If you have issues with the app not functioning as intended, please raise an issue on the repo.

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.