Skip to content

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

EndpointsBaseCredential
Serverhttps://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

http
Authorization: Klaviyo-API-Key pk_your_private_key

Server 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

http
revision: 2026-10-15

Send 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.

TierBurstSteady
XS1/s15/m
S3/s60/m
M10/s150/m
L75/s750/m
XL350/s3,500/m
PUSH150/s1,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.

Areas of the API

AreaEndpoints hereKlaviyo operations built
Accounts42 of 2
Billing22 of 2
Brands2525 of 25
Campaigns5959 of 59
Catalogs5555 of 55
Client1212 of 12
Conversations11 of 1
Coupons1717 of 17
Custom Objects3939 of 39
Data Privacy11 of 1
Events88 of 8
Flows2222 of 22
Forms1212 of 12
Images55 of 5
Lists1313 of 13
Metrics2424 of 24
Profiles3838 of 38
Reporting77 of 7
Reviews33 of 3
Segments1111 of 11
Tags2626 of 26
Templates1717 of 17
Text Messaging99 of 9
Tracking Settings33 of 3
Translations55 of 13
Web Feeds55 of 5
Webhooks77 of 7