API reference
API overview
What every endpoint shares: where to send requests, keys, revisions, rate limits and the document format.
This server answers 430 endpoints in 27 areas. 428 of them are operations from Klaviyo's API, revision 2026-10-15, which has 436 in all. The compatibility page lists the rest.
Base URL
| Endpoints | Base | Credential |
|---|---|---|
| Server | https://email.growthdept.ai/api/... | A private key |
| Client (browsers and apps) | https://email.growthdept.ai/client/... | The public key in company_id |
Requests and responses use HTTPS and JSON. Paths end with or without a slash; both forms answer the same way.
OpenAPI document
/api/openapi.json is an OpenAPI 3.1 document built from the same route definitions that serve requests, so it lists exactly the endpoints on these pages. Load it into an HTTP client or a code generator. Each operation names the Klaviyo response schema it follows.
Authentication
Authorization: Klaviyo-API-Key pk_your_private_keyServer endpoints take a private key in the Authorization header and check its scopes. Client endpoints take the account's public key as company_id. Read authentication for keys, scopes and errors.
Revisions
revision: 2026-10-15Send a revision header on every request. This server implements 2026-10-15 and answers earlier dates the same way. See revisions.
Rate limits
Each endpoint is in one tier. Both limits apply at once; every endpoint page shows its own.
| Tier | Burst | Steady |
|---|---|---|
XS | 1/s | 15/m |
S | 3/s | 60/m |
M | 10/s | 150/m |
L | 75/s | 750/m |
XL | 350/s | 3,500/m |
PUSH | 150/s | 1,400/m |
Over a limit, the answer is 429 with a Retry-After header. See rate limits.
Requests and responses
Bodies are JSON:API documents in application/vnd.api+json, up to 5 MB. Each resource has a type, an id, attributes, relationships and links. Errors come back as an errors array; see errors.
- Filtering:
filter=equals(email,"...") - Sorting:
sort=-created - Pagination:
page[size]andpage[cursor] - Sparse fieldsets:
fields[profile]=email - Relationships and includes:
include=metric
Areas of the API
| Area | Endpoints here | Klaviyo operations built |
|---|---|---|
| Accounts | 4 | 2 of 2 |
| Billing | 2 | 2 of 2 |
| Brands | 25 | 25 of 25 |
| Campaigns | 59 | 59 of 59 |
| Catalogs | 55 | 55 of 55 |
| Client | 12 | 12 of 12 |
| Conversations | 1 | 1 of 1 |
| Coupons | 17 | 17 of 17 |
| Custom Objects | 39 | 39 of 39 |
| Data Privacy | 1 | 1 of 1 |
| Events | 8 | 8 of 8 |
| Flows | 22 | 22 of 22 |
| Forms | 12 | 12 of 12 |
| Images | 5 | 5 of 5 |
| Lists | 13 | 13 of 13 |
| Metrics | 24 | 24 of 24 |
| Profiles | 38 | 38 of 38 |
| Reporting | 7 | 7 of 7 |
| Reviews | 3 | 3 of 3 |
| Segments | 11 | 11 of 11 |
| Tags | 26 | 26 of 26 |
| Templates | 17 | 17 of 17 |
| Text Messaging | 9 | 9 of 9 |
| Tracking Settings | 3 | 3 of 3 |
| Translations | 5 | 5 of 13 |
| Web Feeds | 5 | 5 of 5 |
| Webhooks | 7 | 7 of 7 |