Skip to content
Office

Office Desk feature

API and webhooks

Read and change tickets from your own code, and get a signed webhook whenever something happens.

REST API

With an API key you can list tickets with filters, get one, create one (with the customer by email), update fields, status, assignment and tags, and add a reply (emailed to the customer) or a note. There are endpoints for customers, companies, groups, agents, tags, views and canned responses.

Creates accept an Idempotency-Key header, so a retry never makes two tickets. Keys are rate limited and only see the tickets their owner can see.

Webhooks

Point a webhook at your URL and Desk sends a signed POST when a ticket is created, updated, assigned or closed, when its status changes, when a reply or note is added, when a customer is created, when an SLA is breached and when a survey comes back. Failed deliveries retry, and the delivery log lets you resend any of them. Rules can also send a webhook as an action.

Zapier, Make and n8n

Use a "catch hook" trigger in any of them with a Desk webhook, and call the API from their HTTP step to act on tickets.

Example

Uptime alerts that open tickets

A SaaS team's monitoring tool calls a small script when the API is down. The script creates a Desk ticket with POST /api/v1/desk/tickets, priority Urgent, tag outage, and an Idempotency-Key of the alert id, so repeated alerts don't stack up. When the ticket closes, a desk.ticket.closed webhook posts to their status page tool to mark the incident resolved.

How to set it up

  1. 1

    Open Settings, then API keys, and create a key with read or read and write access.

  2. 2

    Open Settings, then Webhooks, add your URL and pick the events.

  3. 3

    Check each request's signature with your webhook secret.

API and webhooks is part of Office Desk and included on every plan.

Questions people ask

Can an AI assistant read my tickets?

An MCP connection, so an assistant like Claude can read tickets and draft replies that wait for an agent to send them, is coming soon.

Try Office Desk with your whole team

7-day trial with every feature. Cancel from the billing page whenever you like.