Klaviyo

Read and write Klaviyo profiles, lists, list membership, events and catalog items, with explicit-consent subscribe, and read segments, metrics, campaigns, flows and coupons.

Keep customer profiles, purchase events and product catalogues in Klaviyo in step with commerce and CRM systems so segments and flows act on current data.

Build a flow with Klaviyo Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

campaigns

List campaigns
Source
Incremental
Email, SMS or push campaigns with status and schedule.

catalog items

Create catalog item
Destination
Duplicate protected
Adds a product to the custom catalogue, keyed by your external ID.
List catalog items
Source
Products in the custom catalogue.
Update catalog item
Destination
Duplicate protected
Updates a custom catalogue product.

coupon codes

List coupon codes
Source
Unique codes for one coupon, with status, expiry and assigned profile.

coupons

List coupons
Source
Coupons configured for unique coupon codes.

events

Create event
Destination
Duplicate protected
Records an activity event for a profile identified by email, phone or external ID. Can trigger flows.
List events
Source
Incremental
Activity events (placed order, opened email and others), oldest first, since a time.

flows

List flows
Source
Automation flows with status and trigger type.

list profiles

Add profiles to list
Destination
Duplicate protected
Adds up to 1,000 existing profiles to a list. Does not change marketing consent.
List list profiles
Source
Profiles on one list with consent status.

lists

Create list
Destination
Not retried automatically
Creates a list.
Get list
Source
One list with its opt-in process and profile count.
List lists
Source
Incremental
Lists in the account, most recently updated first.
Rename list
Destination
Duplicate protected
Changes a list's name.

metrics

List metrics
Source
Event metrics (activity types) and their integration source.

profile subscriptions

Subscribe profile to email marketing
Destination
Duplicate protected
Records explicit email marketing consent for one profile, optionally on a list, through a Klaviyo bulk subscribe job.

profiles

Create profile
Destination
Not retried automatically
Creates a profile. Does not subscribe it to marketing.
Get profile
Source
One profile with custom properties and consent status.
List profiles
Source
Incremental
Profiles with consent status, ordered by last update for incremental sync, optionally filtered by email.
Update profile
Destination
Duplicate protected
Updates attributes and custom properties of one profile. Omitted fields are unchanged; consent is never changed.
Create or update profile
Destination
Duplicate protected
Creates a profile or updates the one matching the email (profile import). Consent is never changed.

segment profiles

List segment profiles
Source
Profiles currently in one segment with consent status.

segments

List segments
Source
Segments with their active and starred state.

Authentication

Private API key

Plans and access

All Klaviyo plans, including Free. Private API keys can be limited to read or full access per scope (profiles, lists, segments, events, metrics, campaigns, flows, catalogs, coupons, subscriptions).

Test environment

Use a free Klaviyo account or a test account; Klaviyo has no separate sandbox host.

Rate limits

Per-endpoint burst and steady limits by tier (XS 1/s 15/min up to XL 350/s 3,500/min); HTTP 429 with Retry-After.

Provider events

System webhooks and flow webhooks for profile and event activity. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Only profile_subscriptions.create changes consent, and only when the explicit SUBSCRIBED consent input is given. Profile create, update and import never change consent.
Adding profiles to a list does not subscribe them to marketing; Klaviyo keeps consent separate from list membership.
Unsubscribe, suppression, campaign sends, flow changes and all deletes are not implemented.
Profile create, list create and catalog writes are not de-duplicated except where Klaviyo enforces unique identifiers (email, phone, external ID, catalog external ID).
Events are de-duplicated by Klaviyo on unique_id for the same profile and metric; Nexra requires a unique ID for event creation.
Lists return at most 10 per page (Klaviyo limit).