v17.0.0

[17.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.

v16.0.0

[16.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 anonymous_id from profile payloads

v15.0.0

[15.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.

v14.0.1

[14.0.1] - revision 2025-07-15

Fixed

• Added nil check when accessing Retry-After header

v14.0.0

[14.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.

v13.0.1

[13.0.1] - revision 2025-04-15

Fixed

• Fixed ApiError initialization so that it doesn't swallow errors

Changed

• Removed API revision from comment on files

v13.0.0

Version 13.0.0

v12.0.0

Version 12.0.0

v11.1.0

Version 11.1.0

v11.0.0

Version 11.0.0