Changelog
Review new and breaking changes to Klaviyo's APIs.
Welcome to the Klaviyo API Changelog! Review new and breaking changes to Klaviyo's APIs. Select a revision header from the table of contents on the right to review changes for a specific revision. To view API reference and guides for a specific revision header, select it from the version dropdown in the upper left menu.
Revision 2023-02-22
2023-02-22
New endpoints
- Campaigns: Use our new Campaigns API endpoints to programmatically create, update, delete, and send email campaigns. See the API reference documentation for more info. We plan to introduce SMS support in the future.
Breaking changes
- Updated Flows endpoints to use cursor-based pagination. This change brings flows pagination to parity with our other API endpoints. You can learn more about cursor-based pagination in our API Overview.
- Profile fields can now be nulled out by passing
null
into a profile field via the Update Profile endpoint.
Update 2023-06-06
- The steady rate limit for Create Client Subscription has increased to
700/m
.
Update 2023-05-30
- Get Profiles now support filtering by a
datetime
range. You can filter adatetime
range by using thegreater-than
andless-than
filters in combination, similar to this example:https://a.klaviyo.com/api/profiles/?filter=less-than(updated,2023-04-26T00:00:00Z),greater-than(updated,2023-04-19T00:00:00Z)
.
Update 2023-04-06
- The Get Profile and Get Profiles endpoints now allow you to request predictive analytics such as customer lifetime value (CLV), along with other profile information. You can request these new fields by appending
?additional-fields[profile]=predictive_analytics
to the request URL. - Each
relationship
endpoint has been split to make a specific endpoint URL for each unique related resource field. Note, this is only a documentation change. For example, theGet Profile Relationships
endpoint is now split into Get Profile Relationships Lists and Get Profile Relationships Segments endpoints in the documentation. The URLs for these endpoints remain unchanged.
Update 2023-03-28
- You can now
filter
events using theprofile_id
field in Get Events. This allows you to retrieve all the events for a given profile for all metrics or retrieve events for a specific metric if paired with themetric_id
filter.
Update 2023-03-07
- The Get Profile and Get Profiles endpoints now include each profile’s email and SMS subscription information, including:
- Their current consent status.
- When and how they subscribed or unsubscribed.
- Their global and list-specific suppressions (email only).
- You can now
filter
andsort
profiles using theupdated
field in Get Profiles.
Revision 2023-01-24
2023-01-24
New endpoints
- Tags: Use our new Tags API endpoints to create, read, update, and delete tags on various Klaviyo objects such as campaigns, flows, lists and segments. See the API reference documentation for more info.
- Data Privacy - Request Profile Deletion: Use our new Data Privacy - Request Profile Deletion API endpoint to delete profiles with a provided identifier (i.e.
profile_id
,email
,phone_number
). See the API reference documentation for more info.
Breaking changes
- Changed url path for Create Template Render from
https://a.klaviyo.com/api/templates/{id}/render/
tohttps://a.klaviyo.com/api/template-render/
- Changed url path for Create Template Clone from
https://a.klaviyo.com/api/templates/{id}/clone/
tohttps://a.klaviyo.com/api/template-clone/
Update 2023-02-14
- The
price
field can now be optionally supplied in the payload for Create Catalog Item and Update Catalog Item endpoints. This field can be used to set the price on the catalog item.
Update 2023-02-07
-
A
channels
object can now be optionally supplied in the payload for the Subscribe Profiles endpoint. Whenchannels
is provided, only the specified channels and message types will be subscribed. Ifchannels
is not provided, we will subscribe all channels for which identifiers (i.e.phone_number
oremail
) are provided. -
The
profile_id
field can now be optionally supplied in the payload for the Subscribe Profiles endpoint. This will be the id of the profile to subscribe.
Revision 2022-10-17
2022-10-17
- Welcome to our new API changelog! This log will be kept up-to-date on the latest changes, bug fixes, and breaking changes to Klaviyo's APIs. Please note that this changelog only includes changes to new APIs released after 10/19/2022.
- For further information about revisions and breaking changes, please review the API versioning & deprecation policy.
- Kickstart your migration to Klaviyo's new APIs with the API comparison chart, a detailed overview of what's changed from the v1/v2 endpoints to the new endpoints.
Update 2023-01-20
- The
list_id
attribute for the Unsubscribe Profiles endpoint is now an optional attribute instead of a required.
Update 2023-01-11
- The Create Profile and Update Profile endpoints now accept a phone number as an identifier even if SMS is not set up in the associated Klaviyo account. A successful call requires one other profile identifier attribute (
email
,external_id
, oranonymous_id
), in addition to a phone number.
Update 2022-12-19
- The reference documentation and OpenAPI Spec (OAS) for the Create Template Render and Create Template Clone endpoints have been updated to reflect the correct required fields. This update resolves a minor bug in our documentation where a required field needed to call the endpoints successfully was missing. No changes have been made to these endpoints.
Update 2022-11-02
Breaking change
- Removed the
updated
filter parameter from the Get Profiles endpoint. This filter parameter was not intended for GA release and is not officially supported.- This change takes effect immediately due to site reliability concerns. Please refer to the breaking change policy for more information.
Updated over 1 year ago