v22.0.0

[22.0.0] - revision 2026-04-15

Added

• Conversations API
  • Send an outbound message to a profile with Create Conversation Message. Supports SMS and WhatsApp — the channel is determined automatically from the conversation. Conversation message endpoints use the SMALL rate limit tier (3 requests/second burst, 60 requests/minute steady).
  • Retrieve the conversation thread for a given profile with Get Conversation for Profile, or include it inline on profile retrievals using ?include=conversation.

Changed

• Drag-and-drop templates
  • Create drag-and-drop email templates programmaatically by setting editor_type: SYSTEM_DRAGGABLE and providing a definition body (mutually exclusive with html) via Create Template. DnD template endpoints use the SMALL rate limit tier (3 requests/second burst, 60 requests/minute steady).
  • List and retrieve drag-and-drog templates with Get Templates and Get Template. Use additional-fields[template]=definition to include the full template definition in the response.
  • Update an existing drag-and-drop template’s definition, name, or text independently via Update Template.

v21.0.1

[21.0.1] - revision 2026-01-15

Added

• Events Api
  • Added pageSize parameter to the get_events endpoint: EventsApi.getEvents().
    • Default: 200. Min: 1. Max: 1000.

Fixed

• Fixed TypeScript compile error when indexing serializer data object.

v21.0.0

[21.0.0] - revision 2026-01-15

Added

• Added a new single data source record create endpoint for one-at-a-time ingestion workloads

Changed

• Breaking: removed anonymousId from profile payloads

v20.0.0

[20.0.0] - revision 2025-10-15

Added

Flow Actions API

• Get flow actions, flow messages, flow action IDs, and more with the Flow Actions API.
• Update flow actions within a flow, including associated message content, with the Update Flow Action endpoint.

Updated

Forms API

• Retrieve a form and its definition with the Forms API.
• Use the Create Form endpoint to generate a new form by providing the status, A/B test preference, and name of the form.

v19.0.2

[19.0.2] - revision 2025-07-15

Fixed

• Fixed types used in flow creation

v19.0.1

[19.0.1] - revision 2025-07-15

Fixed

• Fixed issue with segments deserialization

v19.0.0

[19.0.0] - revision 2025-07-15

Added

Mapped Metrics API

• Use the Mapped Metrics API to retrieve some or all mapped metrics in your Klaviyo account, or update a mapped metric.
• Get the metric, custom metric, or associated metric IDs for a given mapped metric.

Custom Objects API

• Use the Custom Objects API to ingest data records from other third-party sources into Klaviyo and retrieve all available data sources for an account.
• Use ingested data records to create custom objects in a Klaviyo account.

v18.0.0

Version 18.0.0

v17.0.0

Version 17.0.0

v16.0.0

Version 16.0.0