Klaviyo
Sync customer profiles to Klaviyo for email and SMS marketing automation. Keep your Klaviyo profiles and lists in sync with your warehouse data.
Prerequisites
- A Klaviyo account
- A Klaviyo private API key (starts with
pk_)
Authentication
Klaviyo uses Private API Key authentication.
- In Klaviyo, go to Settings > API keys
- Create a new private API key
- Copy the key (starts with
pk_) - Paste it into the Private API Key field in SignalSmith
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| API Revision | Text | No | Klaviyo API revision date. Default: 2024-02-15 |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| List ID | Text | No | Existing Klaviyo list ID. Leave blank to use List Name for auto-creation. |
| List Name | Text | No | Name of the list to sync to. A new list is created if List ID is blank. |
Supported Operations
Sync Modes: Upsert, Insert
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Field | Description |
|---|---|
| Primary profile identifier |
Default Destination Fields
email, phone_number, external_id, first_name, last_name, title, organization, city, region, country, zip, image, latitude, longitude
Troubleshooting
Invalid API key format
Klaviyo private API keys must start with pk_. Public API keys (starting with other prefixes) cannot be used for server-side operations.
List not found
If specifying a List ID, verify it in Klaviyo under Audience > Lists & Segments. The List ID is visible in the list URL.
Profile not updating
Klaviyo identifies profiles by email. Ensure the email field is correctly mapped and contains valid email addresses.