Understand profile subscription data
Generated by Klaviyo AI
The article explains how subscriber consent data is now exposed in the profiles API via a dedicated subscriptions object. It outlines the fields available for each channel and how this enables more granular subscription management and validation.
- Subscriptions object: Profiles API responses now include a subscriptions object containing consent data for each communication channel.
- Detailed consent fields: Each channel’s subscription entry includes consent status, timestamp, method, method detail, custom method detail, double opt-in flag, and suppression information.
- Suppression tracking: The subscriptions object records both global suppressions and list-level suppressions for more precise control.
- Granular management: Access to detailed subscription metadata enables more granular management of user subscriptions and validation of how and where consent was collected.
When querying profiles from Klaviyo’s API, it’s critical to know the profile’s detailed subscription status.
Subscriptions object in profile response body
The new profile response body now includes an object called “subscriptions.” This houses all of the data for the consent status for various channels for the profile.
The subscription object includes detailed information for each channel:
- Consent status (subscribed, never subscribed, unsubscribed)
- Timestamp
- Method
- Method detail
- Custom method detail
- Double opt-in (true/false)
- Global suppressions
- List suppressions
Easily manage subscribers
This new inclusion into the profile object enables more granular subscription management for your users. It allows you to quickly validate statuses and ascertain how and where subscription status was collected.
Want to stay in the know? Read more about the improvements we’re making to our APIs or join our developer community today.
Related content
