Zendesk Connector

Last updated:

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

OptionDescription
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.

Questions?

Was this page useful?

Next article

Airbyte Exporter

What does the Airbyte Export app do? This Airbyte Export app sends data from PostHog, to Airbyte. It supports both Full Refresh and Incremental syncs. You can choose if this app will copy only the new or updated event data, or all rows in the tables and columns you set up for replication, every time a sync is run. What are the requirements for this app? Using the Airbyte Export app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running…

Read next article