TalonOne Connector

Sync SegOps segment membership to TalonOne audiences for powering loyalty tiers, personalized promotions, and campaign targeting.

Required Configuration Fields#

Setup Steps#

1. In TalonOne, navigate to Settings → API and create a Management API key with audience read/write permissions.
2. In TalonOne, create or identify an Audience under Audiences in the left nav. Copy its ID.
3. In SegOps, go to Settings → Activations → + New Connector and select TalonOne.
4. Enter the Segment you want to sync, your Base URL, API Key, and Audience ID.
5. Click Create, then toggle to Active.

curl -X POST https://api.segops.ai/api/activations/ \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": 7,
    "connector_type": "talone",
    "config": {
      "base_url": "https://mycompany.talon.one",
      "api_key": "your-management-api-key",
      "audience_id": "12345"
    }
  }'

How Sync Works#

After each SegOps segment recompute, the TalonOne connector:

1. Computes the membership delta
2. Calls the TalonOne Management API to add entered users to the audience: PUT /v1/audiences/<id>/members
3. Removes exited users: DELETE /v1/audiences/<id>/members
4. Updates last_synced_at on success

Use Cases#

• Loyalty tiers— sync “Gold Tier” and “Platinum Tier” segments to separate TalonOne audiences, then use audience conditions in campaign rules to grant exclusive discounts.
• Win-back campaigns — sync churned customers to a TalonOne audience and trigger a personalized win-back discount rule.
• High-value customer promotions — identify high-LTV customers in SegOps and sync them to TalonOne for VIP promotions.