Events and Profiles API

This API is in early access. Sign up to the User Events API early access program to use it.

The Events and Profiles API consists of events, profiles, and people.

Events let you build a timeline of all your customers' interactions from any source. Events can be any programmatic event, including purchase transactions, website visits, or customer service interactions. Each event is associated with a customer who triggered the event.

Profiles let you create a single view of a customer across applications and systems. A profile can contain the various identities of a user in different applications and systems.

People are the customers who have profiles created with either the Profiles or the Events APIs. The API defines each customer as a person with one or more profiles.

The Events and Profiles API is available on the Enterprise plan for Zendesk Support. If you're interested in becoming a Zendesk developer partner, you can convert a trial account into a sponsored Zendesk Support account. The sponsored account is on the Enterprise plan with up to 5 agents. See Getting a trial or sponsored account for development in the Develop Help Center.

Documentation

This is the reference documentation for the Events and Profiles API.

In addition to this API reference, the following resources are available in the Develop Help Center:

API path

The Events and Profiles API has the following path:

https://{subdomain}.zendesk.com/api/cdp/v2/

where {subdomain} is the subdomain of your Zendesk Support account.

Authentication

Authentication works as described in the Security and Authentication in the Zendesk v2 API documentation.

Pagination

Pagination works as described in Pagination in the Zendesk v2 API documentation.

Content type

The Events and Profiles API is a JSON API.

  • POST requests require a "Content-Type: application/json" header

  • GET requests require a "Accept: application/json" header

Rate limits

The rate limit is [??] requests per minute. This includes requests made from the Zendesk Apps framework.

If you exceed the rate limit, the API responds with a HTTP 429 Too Many Requests response code and a body that details the reason for the rate limiter kicking in. The response has a "Retry-After" header that tells you for how many seconds to wait before retrying.

Storage limits:

Records
Events
Profiles

Legal notices

Your use and access to the API is expressly conditioned on your compliance with the policies, restrictions, and other provisions related to the API set forth in our API Restrictions and Responsibilities, in our Change Policy, and in the other documentation we provide you. You must also comply with the restrictions set forth in the Zendesk Master Subscription Agreement and the Zendesk Privacy Policy, in all uses of the API. If Zendesk believes that you have or attempted to violate any term, condition, or the spirit of these policies or agreements, your right to access and use the API may be temporarily or permanently revoked.