gary.club Public API
REST endpoints, signed outbound webhooks, and a remote Model Context Protocol server — one bearer token, one tenancy model. Built for n8n, Claude, Zapier, and any tool you bring.
Two-minute tour#
Mint an API key in your agency dashboard, pass it as a Bearer token, and you're in. Every request is scoped to your organization automatically.
curl https://agency.gary.club/api/public/v1/me \
-H "Authorization: Bearer gc_live_EXAMPLE_AbCdEfGhIj0123456789"
# 200 OK
# {
# "api_key": { "id": "...", "kind": "agency" },
# "tenant": { "org_id": "...", "client_id": null, "is_client_scoped": false }
# }Two key shapes#
Pick the one that matches your trust boundary:
gc_live_…Org-wide. Reads and writes the agency's own CRM by default. Pass X-Gary-Client-Id per-request to act as one of your clients.
cl_live_…Bound to one client. Cross-client reads return 404 — no leakage possible. Hand these to integrations that should only see one customer's data.
Get started#
Quickstart
Make your first call in five minutes — curl, Node, Python, n8n, Claude.
Authentication
Two key shapes — agency + per-client. Full access, the act-as-client header, rate limits.
Errors
Uniform error shape and the codes you should branch on.
Webhooks
Subscribe to live events. HMAC-SHA256 verification, retries, dead-letter.
Resources#
Contacts
Idempotent upsert by email or phone, list, update, archive.
Companies
Account-level rows. Auto-resolved by domain when contacts arrive.
Deals
Pipelines, stages, status moves. Stage moves fire deal.stage_changed.
SMS
Send + read bidirectional messages. FUEL-metered through your provider.
SMS Broadcasts
Headless broadcasts — schedule, approve, send, read recipient state.
Calls
Read calls, transcripts, recordings. List your AI agent templates.
SDR Campaigns
Outbound voice — create, schedule, pause, resume dialing campaigns.
Sequences
Multi-step nurture ladders. Idempotent enrollment from n8n.
Knowledge Base
List KBs, add and remove documents. Voyage handles ingestion async.
AI Gist
AI summaries for contacts, companies, and deals — 1 FUEL, cached 24h.
Billing
FUEL balance, transactions, usage by service. Read-only.
MCP server
Connect Claude Desktop / Code natively — every endpoint as a tool.
Three ways to use it#
Pick whichever fits your stack — they all share one auth layer and one tenant model.
Plain HTTP + JSON. Works with curl, every language, every workflow tool. Start at Quickstart.
We POST signed payloads to your URL when something happens. Wire your n8n trigger in a minute.
Drop a JSON config into Claude Desktop and the entire API becomes native tools. Setup →
Status#
POST /v1/calls (outbound dial trigger) is Phase 1.5; until then it returns 403 feature_disabled with a status note.Full reference#
Every endpoint, every parameter, every response shape — rendered live from the OpenAPI 3.1 spec at /openapi.json. Try requests directly with your own key. Open the reference →