Segment

analytics 17 tools available

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

About this integration

Connect Segment to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call Segment's 17 tools directly from chat or scheduled flows. Plug into a data-analysis persona to ask questions in plain English — the agent runs the queries.

Connect Segment to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 17 exposed

Plans All, incl. Free

Data Never trained on

Segment · in workflows

What teams actually run.

Three patterns teams run with Segment on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Weekly anomaly digest

│ Query metrics from this tool

│ Compare against rolling baseline

└ Surface anomalies with reasoning

Funnel deep-dive

│ Pull funnel events for a date range

│ Compute drop-offs at each step

└ Generate a written analysis

Cohort answers on demand

│ User asks a question in chat

│ Agent translates it to a query

└ Returns numbers + a chart-ready summary

17 tools available

The Segment toolbox.

Every Segment capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

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

Tool to alias a previous user ID to a new user ID. Use when merging anonymous and known identities.

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.

Delete Source

Tool to delete a Segment Source. Use when you need to permanently remove a Source by its ID after confirmation.

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.

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

Tool to associate an identified user with a group via Segment HTTP Tracking API. Use when grouping users with traits.

Segment Identify

Tool to identify a user and set/update traits via Segment HTTP Tracking API.

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.

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.

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.

List Schema Settings in Source

Retrieve schema configuration settings for a Source.

Segment Page View

Tool to record a page view via Segment HTTP Tracking API. Use when sending page views with optional page name and properties.

Remove Source Write Key

Tool to remove a write key from a Source. Use when you need to revoke an existing write key for security or rotation.

Segment Screen Event

Tool to record a mobile app screen view. Use when tracking screen views in a mobile app via Segment HTTP Tracking API.

Segment Track Event

Tool to record a custom user event via Segment HTTP Tracking API. Use when sending events to Segment with valid identity.

Update Source

Tool to update a Source's metadata and settings. Use when you need to modify an existing Source after confirming its ID.

See it run

One prompt, start to finish.

A real prompt, the Segment tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Segment task end-to-end — plan it, execute across the API, and hand back a verified result.

segment.add_labels_to_source Tool to add existing labels to a Source. Use when you have the source ID and want to tag i

segment.segment_alias Tool to alias a previous user ID to a new user ID. Use when merging anonymous and known id

segment.batch_segment_analytics_events Tool to send multiple analytics calls in a single batch request. Use when you want to redu · verified

done

Done. Segment responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Segment

Questions, answered.

What teams ask before connecting Segment.

01 What can I automate with Segment on Definable?

Anything Segment exposes through its API. Common analytics workflows on Definable include answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas can call any of the 17 Segment tools directly, then chain the result into another integration without you writing code.

02 How does Segment authentication work?

Segment uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

03 Is the Segment integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 17 Segment tools. You only need a separate Segment subscription if Segment itself charges per seat or per API call.

04 Is using Segment through Definable secure?

Every call from a persona to Segment is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

05 How do I get started with Segment on Definable?

Sign up for Definable, open the integrations page, find Segment, and connect via OAuth or API key. You can immediately attach Segment to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

06 What Segment actions does Definable expose?

Definable exposes all 17 Segment actions as callable tools — including `Add Labels to Source`, `Segment Alias`, `Batch Segment Analytics Events`, plus 14 more. Each tool gets a typed parameter schema so personas know exactly how to call it.