Requests to the Zendesk Support API may be subject to the following usage limits:

Notwithstanding the limits specified in this document, the system might still limit requests if it detects an unusual spike in requests from all sources for the account, including internal product requests. For example, this can happen in a denial-of-service attack. See Account limit.

Monitoring your request activity

You can compare your request activity in the last 24 hours against your rate limit. See Tracking API activity against your rate limit.

You can use the following response headers to confirm the account's current rate limit and monitor the number of requests remaining in the current minute:

X-Rate-Limit: 700X-Rate-Limit-Remaining: 699

See Best practices for avoiding rate limiting.

If the rate limit is exceeded, 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. You should anticipate this in your API client for the smoothest possible experience.

Zendesk Suite plan limits

The following limits apply depending on your Zendesk Suite plan type.

Limit Team Growth Professional Enterprise Enterprise Plus
Custom Objects, Profiles, and Events API requests per minute 250 250 500 700 1000
Support and Help Center API requests per minute 200 400 400 700 2500
Chat API requests per minute 200 200 200 200 200
Custom objects total 100,000 100,000 250,000 1,000,000 25,000,000
Object types (soft limit) 50 50 50 50 50
Object size 32 KB 32 KB 32 KB 32 KB 32 KB
Relationships total 100,000 100,000 250,000 1,000,000 25,000,000
Relationship types (soft limit) 50 50 50 50 50
Events per month 150,000 150,000 350,000 750,000 3,000,000
Events retention period 90 days 90 days 1 year 1 year 3 years
Profiles per person 20 20 20 20 20
Zendesk Events Connector - Zendesk events sent per minute n/a 5000* 5000 5000 5000

*Only available with the High Volume API add-on.

You can increase the Support and Help Center API rate limits with the High Volume API Add-On.

For additional information about limits, see:

Zendesk Support plan limits

The following Support and Help Center API rate limits apply on your Zendesk Support plan type.

Plan Requests per minute
Essential (legacy) 10
Team 200
Professional 400
Enterprise 700
High Volume API Add-On 2500

The rate limits for the Help Center API are the same as for the Support API. However, requests to the Help Center API don't count against the rate limit of the Support API, and conversely.

High Volume API Add-on

The High Volume Add-On increases a qualifying plan's limit to 2500 requests per minute to the Support and Help Center APIs. It doesn't add an additional 2500 requests to the plan's limit.

The add-on is available on the Zendesk Suite Growth plan and above, and the Zendesk Support Professional plan and above. The add-on is not required on the Zendesk Suite Enterprise Plus plan because the plan has a built-in rate limit of 2500.

Subject to Zendesk’s prior written consent, Zendesk may allow you to increase API usage limits beyond 2500 requests per minute for an additional fee.

Endpoint rate limits

Some endpoints have their own rate limit. For example, the Update Ticket endpoint has a rate limit of 30 updates to the same ticket by the same agent within a 10-minute period. Zendesk reserves the right to adjust the rate limit for given endpoints to provide a high quality of service for all clients.

Name Path Rate limit
List Tickets GET /api/v2/tickets.json?page={num} 50 requests per minute where num is over 500
Update Ticket PUT /api/v2/tickets/{id}.json 30 requests per 10 mins per user

100 requests per min per account
Incremental Exports global limit GET /api/v2/incremental/* 10 requests per minute
Incremental Exports with High Volume add-on GET /api/v2/incremental/* 30 requests per minute
Exporting Views GET /api/v2/views/{id}/export.json 100000 requests per hour
Update User PUT /api/v2/users/{user_id} 5 requests per minute
Create or Update User POST /api/v2/users/create_or_update 5 requests per minute
Export Search Results GET /api/v2/search/export?query={query} 100 requests per minute

External Content API limits

The Help Center API rate limits apply to the External Content API if no stricter rate limit is documented in the following table.

There is no rate limit on help center searches.

Description Limit
External record creation 770 records per minute
External record size 10000 bytes per record
External sources 3
External types 5
External records 3000

Endpoint volume limits

Starting November 5, 2020, the rate limit for certain endpoints will change after reaching a certain number of pages in a paginated response. If the new limit is exceeded, the API responds with a 429 error with a Retry-After header specifying how many seconds to wait before retrying.

Name Path Rate limit
List Tickets GET /api/v2/tickets After page 500, 50 requests per min
List Users GET /api/v2/users/{id}.json
GET /api/v2/groups/{id}/users
GET /api/v2/organizations/{id}/users
After page 10,000, 100 requests per min
List Tags PUT /api/v2/tickets/{id}.json After page 500, 50 requests per min

Job limit

Some endpoints such as the Update Many Tickets endpoint queue background jobs to do the work. You can have up to 30 queued or running jobs at once. If you exceed the limit, you will receive a "TooManyJobs" error. Example:

{  "error":"TooManyJobs",  "description":"Too many UserBulkUpdateJobV2 jobs are currently queued or running. Try again later.",  "current_job_ids":["14b1939441cb2e96d0c0835ede22ce03", ...]}

Apps rate limit

API requests made by Zendesk apps are subject to an additional rate limit of 100 requests per minute per user per app. See Rate limits in the Apps framework docs.

Account limit

Zendesk might limit requests if it detects an unusual spike in requests from all sources for the account, including internal product requests. For example, this can happen in a denial-of-service attack. The account-wide limit is 100,000 requests per minute.

CPU-time limit

Zendesk also tracks the CPU time an account consumes over time. If you're fetching large volumes of records and get a 429 error even though you're within the documented rate limits, it may be due to a CPU-time limit.