Docs & API

Wire it up in one afternoon

REST API for tickets, routing rules and SLAs, plus a CLI for everything you would otherwise click.

API spec

  • POST /v1/tickets

    Create a ticket from any channel with priority and tags

  • GET /v1/tickets

    Search tickets by status, assignee, client or SLA state

  • POST /v1/tickets/{id}/reply

    Send a reply from your connected mailbox

  • POST /v1/tickets/{id}/assign

    Assign or reassign, overriding round-robin

  • PUT /v1/routing-rules/{name}

    Publish or update a routing rule

  • GET /v1/sla/breaches

    List at-risk and breached SLAs across the desk

CLI reference

# connect a mailbox
hookdesk mailboxes connect gmail \
  --address support@yourcompany.com \
  --assign round-robin:support-team

# set an SLA policy
hookdesk sla create \
  --name enterprise-first-response \
  --target 30m \
  --business-hours \
  --escalate-to support-lead

# tail the live queue
hookdesk tail --status unassigned

Ticket inspector

Watch an email become an owned ticket

The raw inbound email, the enriched ticket Hookdesk builds from it, and a line-level view of everything the rules engine added.

"from": "ada@acmestores.com"
"to": "support@yourcompany.com"
"subject": "Invoice total looks wrong"
"received": "2026-09-02T08:14:22Z"
"body": "Hi, we were billed twice for SO-88213..."
"messageId": "<c41a@mail.gmail.com>"
"spf": "pass"