# Segment AI integration on Definable

> Twilio Segment is a customer data platform that helps businesses collect, clean, and control their customer data.

## What this connects

Twilio Segment is a customer data platform that helps businesses collect, clean, and control their customer data.

Vendor: https://segment.com/

## Tools available

**17** tools available. First 12:

- `SEGMENT_ADD_LABELS_TO_SOURCE` — Add Labels to Source — Tool to add existing labels to a Source. Use when you have the source ID and want to tag it with metadata labels.
- `SEGMENT_ALIAS` — Segment Alias — Tool to alias a previous user ID to a new user ID. Use when merging anonymous and known identities.
- `SEGMENT_BATCH` — Batch Segment Analytics Events — Tool to send multiple analytics calls in a single batch request. Use when you want to reduce HTTP overhead by batching Identify/Track/Page/Screen/Group calls into one request.
- `SEGMENT_DELETE_SOURCE` — Delete Source — Tool to delete a Segment Source. Use when you need to permanently remove a Source by its ID after confirmation.
- `SEGMENT_GET_DAILY_PER_SOURCE_API_CALLS_USAGE` — Get Daily Per Source API Calls Usage — Tool to fetch daily API call counts per source for a given period. Use when you need daily breakdown of API usage by source after determining the reporting period.
- `SEGMENT_GET_DESTINATION` — Get Destination — Tool to retrieve a Destination by ID. Use when you need to fetch the full configuration of a Segment Destination instance by its unique identifier. Falls back US→EU public API and legacy app endpoint; returns minimal envelope on legacy HTML or parse errors.
- `SEGMENT_GROUP` — Segment Group — Tool to associate an identified user with a group via Segment HTTP Tracking API. Use when grouping users with traits.
- `SEGMENT_IDENTIFY` — Segment Identify — Tool to identify a user and set/update traits via Segment HTTP Tracking API.
- `SEGMENT_IMPORT_HISTORICAL_DATA` — Import Historical Data — Tool to import historical data in bulk with support for historical timestamps. Use when you need to backfill or import past events with their original timestamps into Segment.
- `SEGMENT_LIST_CONNECTED_WAREHOUSES_FROM_SOURCE` — List Connected Warehouses From Source — Tool to list warehouses connected to a Source. Use when you need to retrieve warehouses for a given source ID.
- `SEGMENT_LIST_DELIVERY_METRICS_SUMMARY_FROM_DESTINATION` — List Delivery Metrics Summary from Destination — Get an event delivery metrics summary from a Destination. Primary attempt uses Segment Public API; fallback to legacy app host if needed. On HTML fallback responses, returns a minimal valid envelope to maintain contract.
- `SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE` — List Schema Settings in Source — Retrieve schema configuration settings for a Source.

## Auth

Auth schemes: `API_KEY`.

## How agents use Segment

Inside a Definable workflow, Segment is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Segment** — the Researcher (GPT-5.5) pulls context from Segment (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Segment** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Segment (create record, post message, draft email).
- **Designer / Engineer → Distributor → Segment** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Segment (attach file, open PR comment, post status).

The Verifier checks every Segment call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/
- marketing automation — https://definable.ai/apps/category/marketing-automation/

## Related

- HTML page: https://definable.ai/apps/segment/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt