Activation Connectors

Activation connectors push your computed segment memberships to external marketing and personalization platforms automatically after each recompute.

What Activation Does#

Once a segment is computed, a connector syncs the membership changes to an external platform. SegOps diffs the previous and current membership lists and:

• Adds newly-entered users to the platform list/audience
• Removes users who left the segment
• Leaves unchanged members untouched

This ensures your marketing tools always reflect the latest segment state without requiring full re-uploads.

Supported Connectors#

Sync Lifecycle#

1. A segment recompute completes (POST /api/segments/<id>/compute/)
2. SegOps queries all active connectors for that segment
3. Each connector is dispatched to a Celery worker
4. The worker calls the connector's sync method (Klaviyo API, Braze API, etc.)
5. On success: last_synced_at is updated, status stays active
6. On failure: last_error is updated, status set to error

Connector Statuses#

Triggering a Manual Sync#

You can trigger an immediate sync without waiting for the next recompute. In the UI, go to Settings → Activations, find your connector, and click Sync Now. Via the API:

POST /api/activations/<id>/sync/

Best Practices#

• One connector per segment per platform — avoid creating multiple connectors for the same segment/platform combination.
• Compute before activating — always run at least one compute before setting a connector to active. An empty membership list will clear the external audience.
• Monitor errors — check the Analytics → Activations tab for sync logs and connector health.
• API key rotation — if you rotate platform API keys, update the connector config and trigger a manual sync to confirm it works.