SendSetsDocs

Agent tools

Call the SendSets tool registry over REST without an MCP client.

The REST tool surface is the same focused registry served by MCP:

GET /v1/ai/tools
POST /v1/ai/tools/:name/call
Authorization: Bearer ssk_...

Discovery only returns tools allowed by the credential's scopes. Send tools are included and return executed, awaiting_approval, or blocked; policy checks are additional to API scopes.

The focused write tools are create_run, cancel_run, start_campaign, stop_campaign, compose_email, and send_reply. Read operations include get_run, list_runs, and the campaign, sequence, lead, mailbox, warmup, inbox, analytics, suppression, and webhook tools.

Human approval operations are not tools. They are JWT-only REST actions under /v1/approvals, so an agent credential cannot approve its own work.

curl -sS http://localhost:8080/v1/ai/tools/create_run/call \
  -H "Authorization: Bearer $SENDSETS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"arguments":{"idempotency_key":"agent-42","request":{"name":"Founders","intent":"launch"}}}'

The legacy CRM, forms, automation, advisor, and web-research tools are not registered by default. SENDSETS_ENABLE_EXTENDED_SURFACES=true opts an instance back into those unsupported surfaces.