API Reference

Base URL

All API requests go to:

https://api.usegately.com/api/v1

Every request must include your API key as a Bearer token:

Authorization: Bearer gately_sk_live_xxxxxxxxxxxxxxxx

Get your API key from Dashboard → Settings → API Keys. The API key identifies your project automatically — no X-Project-ID header needed.

Legacy /sdk/* paths still work but are deprecated. Use /api/v1/* for all new integrations.

All endpoints return JSON. Successful responses include a success: true field. Errors always include an error string.

// Success
{ "success": true, "data": { ... } }

// Error
{ "error": "Member not found", "code": "NOT_FOUND" }

Code	Meaning
`200`	OK
`201`	Created
`400`	Bad request — check your request body
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — insufficient permissions
`404`	Not found
`429`	Rate limited
`500`	Server error

300 requests / minute per API key
Bulk endpoints (campaigns, imports) count as 1 request regardless of recipient count
Rate limit headers returned on every response: X-RateLimit-Remaining, X-RateLimit-Reset