Sortd Docs

The AI-ready work layer on top of Gmail.

Gmail's API gives an agent a mailbox. Sortd's API gives it a team's email operation — threads become owned, stateful work items with AI classification, assignments, customer context and a human-in-the-loop review flow, through one contract.

Connect your AI Build with the API API reference

Why an agent should call Sortd, not the mailbox

Team state

Who owns a conversation, what stage it's in, who's assigned — across every mailbox on the team.

AI classification

Smart status, urgency, sentiment and risk as structured labels. Raw email bodies stay in Sortd.

Customer context

Sales boards and deal flow alongside the email a thread came from.

Agent-safe

Scopes, idempotency, audit, reversible actions — and a send ladder from drafts-for-review up to no-leak replies, so a key holds exactly the capability you granted.

Connect an assistant in two minutes

https://api.sortd.com/mcp

Paste that URL into Claude, ChatGPT, Cursor or any MCP client, approve the consent screen in your browser — the scopes you approve are the whole permission grant — and ask: "Which Sortd boards can you see?" Per-client steps: Connect your AI. Then put it on a schedule"every hour, check for new mail and file anything urgent."

Five-minute quickstart (API)

# 1. List the teams your key can use
curl https://api.sortd.com/v2/me \
  -H "Authorization: Bearer sk_live_…"

# 2. Find work on a board
curl "https://api.sortd.com/v2/tasks?board_id=brd_…" \
  -H "Authorization: Bearer sk_live_…"

# 3. Create a task (idempotent)
curl -X POST https://api.sortd.com/v2/tasks \
  -H "Authorization: Bearer sk_live_…" \
  -H "Idempotency-Key: my-unique-key" \
  -d '{"list_id":"lst_…","title":"Follow up with Acme"}'

Full walkthrough in the Quickstart. Every response is { data, meta }; tolerate unknown fields.

Built for AI clients

SurfaceWhat it is
REST v2The durable contract — explicit, typed, OpenAPI 3.1.
Connect your AIConnect Sortd inside Claude / ChatGPT / Cursor — hosted server, scope-gated tools (catalog). Open-source stdio server (@sortd/mcp, MIT) too.
AI guidesPrompts, setups and workflows for agents — plus push-driven patterns for runners like n8n that host endpoints and receive webhooks.
AutomateRun the connector on a schedule — hourly mail triage, list watching, morning digests — from Claude Cowork or ChatGPT scheduled tasks.
ZapierREST-hook + polling triggers, idempotent actions, loop detection.
WebhooksStripe-style signed delivery, retries, replay, delivery log.
llms-full.txtThe whole contract in one file, written for models.