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
/apifor servers and/clientfor browsers. - The
Authorization: Klaviyo-API-Keyheader, the public key incompany_id, and scope names such asprofiles:read. - The
revisionheader. - JSON:API documents:
data,type,id,attributes,relationships,links,included. - Query parameters:
filterwith the same operators,sort,page[cursor]andpage[size]with the same sizes,fields[...],additional-fields[...]andinclude. - Error documents, HTTP statuses and error codes.
- Rate limit tiers per endpoint, the
RateLimit-*headers, andRetry-Afteron 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 | |
|---|---|
| Host | https://email.growthdept.ai. Keys are Growth Dept Email keys; a Klaviyo key does not work here. |
| Revisions | Revision 2026-10-15 and earlier dates are answered with 2026-10-15 behaviour. Later dates return 404. See revisions. |
| Coverage | 428 of 436 operations. The rest return 404 not_found saying the operation is not available here yet. |
| OAuth apps | Not available. A Bearer token returns 401. |
| Beta endpoints | Klaviyo's beta (.pre) operations are not part of this API. A .pre suffix on the revision header is accepted and ignored. |
| Rate limits | Counted per private key and per endpoint, rather than shared across the account. |
| Event ids | 26-character ULIDs. Klaviyo's event ids are 11 characters. |
| Error wording | The title and detail are our own words. code and status match. |
| Agent hints | Responses 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.aiinstead of Klaviyo's host. If your client library lets you set the API host, set it there. - Keep sending a
revisionheader. Any date up to2026-10-15works. - 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.
| Area | Built | In Klaviyo's API | |
|---|---|---|---|
| Accounts | 2 | 2 | All |
| Billing | 2 | 2 | All |
| Brands | 25 | 25 | All |
| Campaigns | 59 | 59 | All |
| Catalogs | 55 | 55 | All |
| Client | 12 | 12 | All |
| Conversations | 1 | 1 | All |
| Coupons | 17 | 17 | All |
| Custom Objects | 39 | 39 | All |
| Data Privacy | 1 | 1 | All |
| Events | 8 | 8 | All |
| Flows | 22 | 22 | All |
| Forms | 12 | 12 | All |
| Images | 5 | 5 | All |
| Lists | 13 | 13 | All |
| Metrics | 24 | 24 | All |
| Profiles | 38 | 38 | All |
| Reporting | 7 | 7 | All |
| Reviews | 3 | 3 | All |
| Segments | 11 | 11 | All |
| Tags | 26 | 26 | All |
| Templates | 17 | 17 | All |
| Text Messaging | 9 | 9 | All |
| Tracking Settings | 3 | 3 | All |
| Translations | 5 | 13 | Some |
| Web Feeds | 5 | 5 | All |
| Webhooks | 7 | 7 | All |
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
| Endpoint | What it does |
|---|---|
| GET /api/sending-limits | Get the account's sending limits |
| PATCH /api/sending-limits | Change the account's sending limits |