Skip to content

Commit

Permalink
v7.0.0 release (#44)
Browse files Browse the repository at this point in the history
  • Loading branch information
Ian-Montgomery-Klaviyo authored Oct 16, 2023
1 parent 666d837 commit 4fd2ebc
Show file tree
Hide file tree
Showing 56 changed files with 917 additions and 628 deletions.
48 changes: 48 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,54 @@
# Changelog
All notable changes to this project will be documented in this file.

## [7.0.0] - revision 2023-10-15

### Added

#### Support for returning list suppressions via the [/profiles endpoint](https://developers.klaviyo.com/en/reference/get_profiles)

We now support filtering on list suppression with the get profiles endpoint, which brings us to parity with v2 list suppression endpoint that was the previously recommended solution.

Rules for suppression [filtering](https://developers.klaviyo.com/en/docs/filtering_):

- You may not mix-and-match list and global filters
- You may only specify a single date filter
- You may or may not specify a reason
- You must specify a list_id to filter on any list suppression properties

Examples:

```
{filter: 'greater-than(subscriptions.email.marketing.suppression.timestamp,2023-03-01T01:00:00Z)'}
{filter: 'greater-than(subscriptions.email.marketing.list_suppressions.timestamp,2023-03-01T01:00:00Z),equals(subscriptions.email.marketing.list_suppressions.list_id,”LIST_ID”')
{filter: 'greater-than(subscriptions.email.marketing.suppression.timestamp,2023-03-01T01:00:00Z),equals(subscriptions.email.marketing.suppression.reason,"user_suppressed"')
```
##### Optionally retrieve subscription status on Get List Profiles, Get Segment Profiles, Get Event Profile
Now you can retrieve subscription status on any endpoint that returns profiles, including `getListProfiles`, `getSegmentProfiles` and `getEventProfile`. Use `{additionalFieldsProfile: ['subscriptions']}` on these endpoints to include subscription information.

### Breaking changes

#### Subscription object not returned by default on Get Profile / Get Profiles

The subscription object is no longer returned by default with get profile(s) requests. However, it can be included by adding `?additional-fields[profile]=subscriptions` to the request. This change will allow us to provide a more performant experience when making requests to `GetProfiles` without including the subscriptions object.

#### Profile Subscription Fields Renamed

In the interest of providing more clarity and information on the subscription object, we have renamed several fields, and added several as well. This will provide more context on a contact's subscriptions and consent, as well as boolean fields to see who you can or cannot message.

For SMSMarketing:

- `timestamp` is now `consentTimestamp`
- `lastUpdated` is a new field that mirrors `consenTimestamp`
- `canReceiveSmsMarketing` is a new field which is `True` if the profile is consented for SMS

For EmailMarketing:

- `timestamp` is now `consentTimestamp`
- `canReceiveEmailMarketing` is True if the profile does not have a global suppression
- `suppressions` is now `suppression`
- `lastUpdated` is a new field that is the most recent of all the dates on the object

## [6.0.1] - revision 2023-09-15
### Fixed
- `Relationship` and its child attributes were incorrectly marked as optional for the following endpoints
Expand Down
Loading

0 comments on commit 4fd2ebc

Please sign in to comment.