DocumentationAPI Reference

Webhooks

This is the reference documentation for the Zendesk Webhooks API. The documentation also contains a list of available event types for Zendesk webhooks and their related request payloads.

A webhook sends an HTTP request to a specified URL in response to an activity in Zendesk Support. For example, you can configure a webhook to send requests to an external system when a user is deleted or a new ticket is created.

You can use the Webhooks API to:

  • Create, update, delete, and retrieve webhooks
  • Monitor webhook invocations and invocation attempts
  • Retrieve and reset the signing secret used to verify requests from a Zendesk webhooks

For more information about creating and managing webhooks using the API, see Creating and monitoring webhooks in the developer documentation.

Run in Postman

If you use Postman, you can import the Webhook API endpoints as a collection into your Postman app, then try out different requests to learn how the API works. Click the following button to get started:

Run in Postman

If you don't use Postman, you can sign up for a free account on the Postman website and download the app. For more information about using Postman with Zendesk APIs, see Exploring Zendesk APIs with Postman.

Limits for trial accounts

Trial accounts are limited to a maximum of 10 webhooks and a rate limit of 60 invocations per minute.

Webhook retries

Zendesk webhooks retry failed HTTP requests that return certain HTTP response codes. Zendesk also uses a circuit breaker to avoid resending requests to broken endpoints.

For more information about webhook retry logic and the circuit breaker, see Creating and monitoring webhooks.