SegOps AIDocs

Braze Connector

Sync SegOps segment membership to Braze via subscription groups or user attributes. Members are added and removed automatically after each segment recompute.

Required Configuration Fields#

FieldDescription
rest_endpointYour Braze REST API endpoint (e.g., https://rest.iad-01.braze.com)
api_keyBraze REST API Key with users.track permission
segment_id(Optional) Braze Segment ID to use for targeting
ℹ Note
Braze REST endpoints vary by data center region. Common values:US-01: https://rest.iad-01.braze.com US-02: https://rest.iad-02.braze.com EU-01: https://rest.fra-01.braze.euCheck your Braze dashboard URL to identify your region.

Setup Steps#

  1. In Braze, go to Settings → APIs and Identifiers and create a new REST API key. Grant it the users.track permission at minimum.
  2. Note your Braze REST Endpoint from the same settings page.
  3. In SegOps, navigate to Settings → Activations → + New Connector and select Braze.
  4. Fill in Segment, REST Endpoint, and API Key.
  5. Optionally add a Segment ID for targeting.
  6. Click Create, then toggle the connector to Active.
bash
curl -X POST https://api.segops.ai/api/activations/ \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": 7,
    "connector_type": "braze",
    "config": {
      "rest_endpoint": "https://rest.iad-01.braze.com",
      "api_key": "your-braze-rest-key",
      "segment_id": "optional-braze-segment-id"
    }
  }'

How Sync Works with Braze#

After each SegOps segment recompute, the Braze connector:

  1. Computes the membership delta (entered/exited users)
  2. Calls POST /users/track with a custom attribute on entering users (e.g., segops_segment_7: true)
  3. Removes the attribute or sets it to false for exiting users
  4. If a segment_id is provided, uses subscription group APIs

Troubleshooting#

  • 401 Unauthorized — verify the API key has the correct permissions (users.track).
  • Wrong endpoint — use the full URL including https://. Do not include a trailing slash.
  • Users not appearing — Braze identifies users by external_id. Ensure your user_id in SegOps matches the external_id in Braze.