Zendesk

Zendesk Support API for reading and writing tickets, users, organizations, and search across a Zendesk help-desk instance. Best for agents that triage incoming tickets, look up customer history, post replies as an internal note or public comment, or sync support data into other systems. Tenants are subdomained at .zendesk.com; users connect by pasting their subdomain plus an admin/agent email and an API token generated in Zendesk Admin Center. 12 example endpoints available through Lava’s AI Gateway. See the Zendesk API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://api.zendesk.com is supported. Zendesk Support API. URL is tenant-specific: https://{subdomain}.zendesk.com/api/v2/{path}. Common roots: /tickets.json (list/create), /tickets/{id}.json (show/update/delete), /tickets/{id}/comments.json (list comments), /search.json?query=… (cross-resource search), /users.json (list/create), /users/{id}.json (show), /users/me.json (current user), /organizations.json, /organizations/{id}.json. Pagination: append page[size]=N (max 100) plus page[after] for cursor pagination on list endpoints. Search rate-limited to 100 req/min per account; other endpoints follow the account plan limits. See https://developer.zendesk.com/api-reference/ for full reference. The endpoints below are curated examples.

Endpoints

List recent tickets. Supports cursor pagination via page[size]=N (max 100) and page[after]. Use sort_by + sort_order for ordering (e.g., updated_at desc).

GET https://<tenant>.zendesk.com/api/v2/tickets.json?page[size]=25&sort_by=updated_at&sort_order=desc — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets.json?page[size]=25&sort_by=updated_at&sort_order=desc', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets.json%3Fpage%5Bsize%5D%3D25%26sort_by%3Dupdated_at%26sort_order%3Ddesc" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

GET https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json?include=users — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json?include=users', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets%2F%7Bticket_id%7D.json%3Finclude%3Dusers" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new ticket. The first comment becomes the initial message; pass requester (by id or email) when creating on behalf of an end-user.

POST https://<tenant>.zendesk.com/api/v2/tickets.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets.json', {
  body: {
"ticket": {
  "subject": "Cannot access account",
  "comment": {
    "body": "Customer reports being locked out after reset."
  },
  "requester": {
    "name": "Ada Lovelace",
    "email": "ada@example.com"
  },
  "priority": "normal"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticket":{"subject":"Cannot access account","comment":{"body":"Customer reports being locked out after reset."},"requester":{"name":"Ada Lovelace","email":"ada@example.com"},"priority":"normal"}}'

Update a ticket. Pass any subset of ticket fields. Set comment.public=false for an internal note. Status transitions: new → open → pending → solved → closed.

PUT https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json', {
  method: 'PUT',
  body: {
"ticket": {
  "status": "pending",
  "priority": "high",
  "comment": {
    "body": "Awaiting customer reply with the latest receipt.",
    "public": false
  }
}
},
});

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets%2F%7Bticket_id%7D.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticket":{"status":"pending","priority":"high","comment":{"body":"Awaiting customer reply with the latest receipt.","public":false}}}'

List the comment thread on a ticket, oldest first. Internal notes appear with public=false.

GET https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}/comments.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}/comments.json', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets%2F%7Bticket_id%7D%2Fcomments.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Search across tickets, users, organizations, and groups using the Zendesk query syntax. Rate-limited to 100 req/min/account; returns up to 1000 results per query.

GET https://<tenant>.zendesk.com/api/v2/search.json?query=type:ticket+status:open+priority:high — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/search.json?query=type:ticket+status:open+priority:high', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Fsearch.json%3Fquery%3Dtype%3Aticket%2Bstatus%3Aopen%2Bpriority%3Ahigh" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List users. Filter with ?role=end-user|agent|admin. Cursor pagination via page[size] and page[after].

GET https://<tenant>.zendesk.com/api/v2/users.json?page[size]=50&role=end-user — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/users.json?page[size]=50&role=end-user', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Fusers.json%3Fpage%5Bsize%5D%3D50%26role%3Dend-user" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Retrieve a single user by ID. Use /users/me.json for the authenticated agent.

GET https://<tenant>.zendesk.com/api/v2/users/{user_id}.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/users/{user_id}.json', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Fusers%2F%7Buser_id%7D.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new end-user, agent, or admin. Email or name is sufficient for an end-user; role defaults to end-user.

POST https://<tenant>.zendesk.com/api/v2/users.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/users.json', {
  body: {
"user": {
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "role": "end-user"
}
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Fusers.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user":{"name":"Ada Lovelace","email":"ada@example.com","role":"end-user"}}'

List organizations with cursor pagination.

GET https://<tenant>.zendesk.com/api/v2/organizations.json?page[size]=50 — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/organizations.json?page[size]=50', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Forganizations.json%3Fpage%5Bsize%5D%3D50" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Retrieve a single organization by ID.

GET https://<tenant>.zendesk.com/api/v2/organizations/{organization_id}.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/organizations/{organization_id}.json', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Forganizations%2F%7Borganization_id%7D.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Delete a ticket by ID. Returns 204 on success. Soft-deleted tickets can be restored from the Deleted Tickets view for 30 days before being permanently purged.

DELETE https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json — Free

SDK
cURL

const data = await lava.gateway('https://<tenant>.zendesk.com/api/v2/tickets/{ticket_id}.json', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2F%3Ctenant%3E.zendesk.com%2Fapi%2Fv2%2Ftickets%2F%7Bticket_id%7D.json" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Endpoints

Create a new ticket. The first comment becomes the initial message; pass requester (by id or email) when creating on behalf of an end-user.

Update a ticket. Pass any subset of ticket fields. Set comment.public=false for an internal note. Status transitions: new → open → pending → solved → closed.

List the comment thread on a ticket, oldest first. Internal notes appear with public=false.

Search across tickets, users, organizations, and groups using the Zendesk query syntax. Rate-limited to 100 req/min/account; returns up to 1000 results per query.

Retrieve a single user by ID. Use /users/me.json for the authenticated agent.

Create a new end-user, agent, or admin. Email or name is sufficient for an end-user; role defaults to end-user.

Retrieve a single organization by ID.

Delete a ticket by ID. Returns 204 on success. Soft-deleted tickets can be restored from the Deleted Tickets view for 30 days before being permanently purged.

Next Steps

All Providers

Forward Proxy

​Endpoints

​List recent tickets. Supports cursor pagination via page[size]=N (max 100) and page[after]. Use sort_by + sort_order for ordering (e.g., updated_at desc).

​Retrieve a single ticket by ID. Add ?include=users,groups,organizations,comment_count to sideload related records.

​Create a new ticket. The first comment becomes the initial message; pass requester (by id or email) when creating on behalf of an end-user.

​Update a ticket. Pass any subset of ticket fields. Set comment.public=false for an internal note. Status transitions: new → open → pending → solved → closed.

​List the comment thread on a ticket, oldest first. Internal notes appear with public=false.

​Search across tickets, users, organizations, and groups using the Zendesk query syntax. Rate-limited to 100 req/min/account; returns up to 1000 results per query.

​List users. Filter with ?role=end-user|agent|admin. Cursor pagination via page[size] and page[after].

​Retrieve a single user by ID. Use /users/me.json for the authenticated agent.

​Create a new end-user, agent, or admin. Email or name is sufficient for an end-user; role defaults to end-user.

​List organizations with cursor pagination.

​Retrieve a single organization by ID.

​Delete a ticket by ID. Returns 204 on success. Soft-deleted tickets can be restored from the Deleted Tickets view for 30 days before being permanently purged.

​Next Steps

All Providers

Forward Proxy

Endpoints

List recent tickets. Supports cursor pagination via page[size]=N (max 100) and page[after]. Use sort_by + sort_order for ordering (e.g., updated_at desc).

Retrieve a single ticket by ID. Add ?include=users,groups,organizations,comment_count to sideload related records.

Create a new ticket. The first comment becomes the initial message; pass requester (by id or email) when creating on behalf of an end-user.

Update a ticket. Pass any subset of ticket fields. Set comment.public=false for an internal note. Status transitions: new → open → pending → solved → closed.

List the comment thread on a ticket, oldest first. Internal notes appear with public=false.

Search across tickets, users, organizations, and groups using the Zendesk query syntax. Rate-limited to 100 req/min/account; returns up to 1000 results per query.

List users. Filter with ?role=end-user|agent|admin. Cursor pagination via page[size] and page[after].

Retrieve a single user by ID. Use /users/me.json for the authenticated agent.

Create a new end-user, agent, or admin. Email or name is sufficient for an end-user; role defaults to end-user.

List organizations with cursor pagination.

Retrieve a single organization by ID.

Delete a ticket by ID. Returns 204 on success. Soft-deleted tickets can be restored from the Deleted Tickets view for 30 days before being permanently purged.

Next Steps