Skip to content

Compatibility

Compatible with Klaviyo's API

What matches Klaviyo's API, what differs, and which operations are built.

The API follows Klaviyo's API, revision 2026-10-15, so a client written for Klaviyo can call Growth Dept Email by changing the host and the key, as long as the operations it uses exist here. Today 428 of Klaviyo's 436 operations are built; the coverage table lists them by area.

What matches

  • Paths, methods and operation ids, under /api for servers and /client for browsers.
  • The Authorization: Klaviyo-API-Key header, the public key in company_id, and scope names such as profiles:read.
  • The revision header.
  • JSON:API documents: data, type, id, attributes, relationships, links, included.
  • Query parameters: filter with the same operators, sort, page[cursor] and page[size] with the same sizes, fields[...], additional-fields[...] and include.
  • Error documents, HTTP statuses and error codes.
  • Rate limit tiers per endpoint, the RateLimit-* headers, and Retry-After on a 429.
  • Id formats, so stored ids stay valid text of the same shape.

Our test suite checks responses against the response schemas Klaviyo publishes for that revision.

What differs

Growth Dept Email
Hosthttps://email.growthdept.ai. Keys are Growth Dept Email keys; a Klaviyo key does not work here.
RevisionsRevision 2026-10-15 and earlier dates are answered with 2026-10-15 behaviour. Later dates return 404. See revisions.
Coverage428 of 436 operations. The rest return 404 not_found saying the operation is not available here yet.
OAuth appsNot available. A Bearer token returns 401.
Beta endpointsKlaviyo's beta (.pre) operations are not part of this API. A .pre suffix on the revision header is accepted and ignored.
Rate limitsCounted per private key and per endpoint, rather than shared across the account.
Event ids26-character ULIDs. Klaviyo's event ids are 11 characters.
Error wordingThe title and detail are our own words. code and status match.
Agent hintsResponses do not include a meta.agent_hints object.

Switching a client

  • Create a private key in Growth Dept Email with the scopes your client uses.
  • Send requests to https://email.growthdept.ai instead of Klaviyo's host. If your client library lets you set the API host, set it there.
  • Keep sending a revision header. Any date up to 2026-10-15 works.
  • Check the coverage table for every operation your client calls. A call to one that is not built yet returns 404, which most clients treat as an error.

Coverage

Generated from the endpoints this server answers, so it changes as endpoints are added.

AreaBuiltIn Klaviyo's API
Accounts22All
Billing22All
Brands2525All
Campaigns5959All
Catalogs5555All
Client1212All
Conversations11All
Coupons1717All
Custom Objects3939All
Data Privacy11All
Events88All
Flows2222All
Forms1212All
Images55All
Lists1313All
Metrics2424All
Profiles3838All
Reporting77All
Reviews33All
Segments1111All
Tags2626All
Templates1717All
Text Messaging99All
Tracking Settings33All
Translations513Some
Web Feeds55All
Webhooks77All
Translations: not built yet (8)
  • GET/api/translations/{id}/campaign-variationget_campaign_variation_for_translation
  • GET/api/translations/{id}/flow-messageget_flow_message_for_translation
  • GET/api/translations/{id}/relationships/campaign-variationget_campaign_variation_id_for_translation
  • GET/api/translations/{id}/relationships/flow-messageget_flow_message_id_for_translation
  • GET/api/translations/{id}/relationships/templateget_template_id_for_translation
  • GET/api/translations/{id}/relationships/template-universal-contentget_template_universal_content_id_for_translation
  • GET/api/translations/{id}/templateget_template_for_translation
  • GET/api/translations/{id}/template-universal-contentget_template_universal_content_for_translation

Endpoints of our own

EndpointWhat it does
GET /api/sending-limitsGet the account's sending limits
PATCH /api/sending-limitsChange the account's sending limits