v19.0.0

[19.0.0] - revision 2026-04-15

Added

• Conversations API
  • Send an outbound message to a profile with $klaviyo->Conversations->createConversationMessage(). 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 $klaviyo->Profiles->getConversationForProfile(), or include it inline on profile retrievals using include: ['conversation'] on getProfile / getProfiles.

Changed

• Drag-and-drop templates
  • Create drag-and-drop email templates programmatically by setting editor_type: SYSTEM_DRAGGABLE and providing a definition body (mutually exclusive with html) via
    $klaviyo->Templates->createTemplate(). DnD template endpoints use the SMALL rate limit tier (3 requests/second burst, 60 requests/minute steady).
  • List and retrieve drag-and-drop templates with $klaviyo->Templates->getTemplates() and $klaviyo->Templates->getTemplate(). 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 $klaviyo->Templates->updateTemplate().

v18.0.0

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

v17.0.0

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

v16.0.0

[16.0.0] - revision 2025-07-15

Changed

• Various changes to improve support for PHP 8
• Breaking: Now requires PHP 8.1
• Breaking: A SplFileObject is required for uploading an image; you can no longer use a raw string

v15.0.0

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

v14.0.2

[14.0.2] - revision 2025-04-15

Added

• Added some PHPDoc type hints

v14.0.1

[14.0.1] - revision 2025-04-15

Changed

• Removed API revision from comment on files

v14.0.0

Version 14.0.0

v13.0.0

Version 13.0.0

v12.1.0

Version 12.1.0