SegOps AIDocs

Klaviyo Connector

Sync SegOps segment membership to a Klaviyo list. Members are added and removed automatically after each segment recompute.

Step 1 — Get Your Klaviyo Private API Key#

  1. Log in to your Klaviyo account
  2. Navigate to Account (top-right) → Settings → API Keys
  3. Click Create Private API Key
  4. Give it a name (e.g., “SegOps Sync”) and grant it Lists Read/Write and Profiles Read/Write permissions
  5. Copy the key — it starts with pk_

Step 2 — Find Your Klaviyo List ID#

  1. In Klaviyo, go to Lists & Segments
  2. Open the list you want to sync with (or create a new one)
  3. The List ID is visible in the URL: klaviyo.com/list/AbCdEf/ — copy the 6-character ID

Step 3 — Create the Connector in SegOps#

  1. In SegOps, navigate to Settings → Activations
  2. Click + New Connector
  3. Select Klaviyo as the connector type
  4. Choose the Segment you want to sync
  5. Fill in List ID and API Key
  6. Click Create

Or via the API:

bash
curl -X POST https://api.segops.ai/api/activations/ \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": 7,
    "connector_type": "klaviyo",
    "config": {
      "list_id": "AbCdEf",
      "api_key": "pk_live_..."
    }
  }'

Step 4 — Set Status to Active#

After creating the connector, its status is inactive. Toggle it to active to enable automatic syncing. In the UI, click the Activate toggle. Via the API:

bash
curl -X PATCH https://api.segops.ai/api/activations/3/ \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{ "status": "active" }'

How Sync Works#

After each segment recompute:

  1. SegOps computes the delta (new members vs. removed members)
  2. New members: their user_id (email or ID) is upserted as a Klaviyo profile and added to the list
  3. Removed members: they are removed from the Klaviyo list (profile is not deleted)
  4. last_synced_at is updated on success
ℹ Note
Klaviyo requires profile email addresses for full personalization. If your user_id is not an email, ensure you've sent a context_identified event with an email trait — SegOps uses that to link the profile.

Troubleshooting#

  • Status is error — check the last_error field in Settings → Activations. Common causes: invalid API key, revoked key, incorrect list ID.
  • Rate limit errors— Klaviyo limits API calls per minute. For very large segments (>100k members), syncs may be slow or retry automatically. Check the Klaviyo API error logs.
  • Invalid list_id — Klaviyo list IDs are case-sensitive and exactly 6 characters. Double-check the ID from the Klaviyo URL.
  • Profiles not appearing — Klaviyo may take a few minutes to index newly added profiles. Check the Klaviyo list directly after a minute.