Segment

Connect AI agents to Segment's Public and Tracking APIs. Agents provision sources and destinations, build and activate Engage audiences, govern data and IAM, monitor delivery and usage, and send live customer events.

Verified 1 trigger 145 actions API key available

Segment website Platform Documentation Capability data verified 2026-07-22

New Audit Event fires when a workspace configuration change occurs

Agent reads the actor, resource, and action from the audit event

Agent classifies the change as routine or destructive

Agent confirms whether the change matches an approved-change list

List Audit Events pulls the surrounding context for the change

The data governance channel receives the event with its details

A data owner confirms a destructive change or flags it for rollback

What This Integration Enables

Agents provision sources and connect them to destinations, warehouses, and Reverse ETL models, shape what flows through with transformations, destination filters, tracking plans, and selective sync, and build, schedule, preview, and activate Engage audiences and Unify computed traits. They govern data by running deletion and suppression regulations at source, cloud-source, or workspace scope and by managing IAM users, groups, invites, and roles. They watch delivery with per-source ingress and per-pair egress metrics, track API-call usage, read the audit trail, and react when new audit events occur. On the data plane, agents send live events to the Tracking API: Track to record an action, Identify to set a user's traits, Group, Page, Screen, Alias, and Batch. Some actions require the matching Segment plan or feature entitlement (Protocols, Functions, Engage, Unify, Reverse ETL, and others), and calls without the entitlement return a permission error. Regulation runs and user or invite deletes are destructive. The connector covers Segment's management and tracking surface; the surrounding flow decides which configuration and event calls run automatically and where a data owner confirms a destructive governance action.

Without FlowRunner

Config drift unnoticed Sources, destinations, and audiences are changed by hand with no live record of who did what

Governance run manually Deletion and suppression regulations are executed directly, without a confirmation gate

Usage tracked in exports API-call usage is pulled into a spreadsheet by hand for month-over-month reporting

With FlowRunner

Live audit feed New Audit Event surfaces every workspace change the moment it happens

Gated destructive actions Deletion and suppression regulations run only after a data owner confirms

Automated usage reporting Get Daily Workspace API Calls appends usage numbers to a tracking record on a routine

Use Case Scenarios

Live governance feed from the audit trail

The New Audit Event trigger fires on a workspace configuration change. The agent reads the actor, resource, and action, classifies the change, and posts each event to a governance channel with Slack so the data team has a live audit feed. A destructive change, like a source deletion, stands out in the feed immediately rather than being discovered when a downstream report goes empty.
Usage reporting on a routine

On a schedule, the agent pulls usage with Get Daily Workspace API Calls (or Get Daily Per Source API Calls) and appends the numbers to a tracking sheet with Google Sheets for month-over-month reporting. The team watches API-call volume trend over time without exporting it by hand, and a spike surfaces as an exception.
Profile enrichment on a new lead

When a new lead is captured, the agent calls Identify User to set the lead's traits and Track Event to record the signup, feeding the customer profile that downstream destinations consume. The lead's profile is populated at the moment of capture, so every tool connected to Segment sees a complete record instead of a stub.

Human-in-Loop Highlight

The decision worth stopping for is not whether to honor a deletion request, it is how wide to make it. Segment splits the regulation surface into three calls with the same name and very different reach: Create Source Regulation touches one source, Create Cloud Source Regulation touches one collection inside a cloud source, and Create Workspace Regulation deletes or suppresses the subject across every stream in the workspace at once. The connector gives an agent all three and no way to walk any of them back. So the agent does the assembly it is good at: it reads List Suppressions and List Workspace Regulations to check whether this subject has already been handled, resolves which sources actually carry the person's data, and then holds. It asks the data owner through Slack: "Deletion request for [subject]. Source-scoped run would cover [sources]; workspace-scoped run covers all [n] streams and cannot be narrowed afterward. Which scope do you want, and do I proceed?" The agent runs the everyday configuration, activation, and tracking work on its own. A person picks the blast radius.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via Slack

Human decides

Agent resumes with decision

Agent Capabilities

145 actions

Workspace and Labels

Get Workspace Returns the workspace the API token belongs to. Used as the first call in a flow to confirm which workspace is about to be changed.
List Labels Returns the key and value tags defined in the workspace, which drive resource organization and access control.
Create Label Creates a label so resources can be grouped and permissioned by it.
Delete Label Permanently deletes a label by key and value. This cannot be undone, and anything scoped by that label loses the scope.

Sources

List Sources Returns a page of sources in the workspace. Used to browse data inputs or resolve a source ID before any other source call.
Get Source Retrieves a single source with its write keys, settings, and metadata. Used to confirm the right source before touching it.
Create Source Creates a new data source from a source type in the catalog. Used to connect a new website, app, or server without opening the Segment UI.
Update Source Updates a source's name, slug, enabled state, or settings. Used to pause or resume a source's data flow without recreating it.
Delete Source Permanently deletes a source and stops it sending data. This cannot be undone, which is why it belongs behind a person.

Destinations

List Destinations Returns a page of destinations in the workspace. Used to audit where customer data is being sent.
Get Destination Retrieves a single destination with its settings and the source it receives data from.
Create Destination Connects a new destination to a source so Segment forwards that source's data to a downstream tool.
Update Destination Updates a destination's name, enabled state, or settings. Used to rotate a key or pause a data flow without recreating the connection.
Delete Destination Permanently deletes a destination and stops Segment forwarding data to it. This cannot be undone.

Destination Filters

List Destination Filters Returns the filters configured on a destination, which drop or sample events before they arrive.
Get Destination Filter Retrieves a single destination filter with its condition and actions.
Create Destination Filter Adds a filter that drops, samples, or trims event properties on a condition. Used to keep specific fields out of a tool for privacy or cost reasons.
Update Destination Filter Updates a filter's condition, actions, or enabled state. Used to adjust what a destination receives without rebuilding the filter.
Delete Destination Filter Permanently removes a filter, so the events it was holding back start flowing again. This cannot be undone.

Transformations

List Transformations Returns the transformations in the workspace, which rename, drop, or rewrite events before they reach destinations.
Get Transformation Retrieves a single transformation with its condition and transform rules.
Create Transformation Creates a rule that rewrites a source's events, including renaming, dropping, and hashing, before they leave Segment.
Update Transformation Updates a transformation's source, condition, or rules. Used to refine a rule without recreating it.
Delete Transformation Permanently deletes a transformation, so the raw event shape reaches destinations again. This cannot be undone.

Warehouses

List Warehouses Returns the warehouses connected to the workspace. Used to browse sync targets or resolve a warehouse ID.
Get Warehouse Retrieves a single warehouse with its connector metadata and non-secret settings.
Create Warehouse Connects a new data warehouse so Segment syncs data into it.
Update Warehouse Updates a warehouse's connection settings, name, or enabled state. Segment requires the full settings object on update, so read before you write.
Delete Warehouse Permanently deletes a warehouse connection and stops syncing into it. This cannot be undone.

Selective Sync

List Warehouse Syncs Returns recent sync reports for a warehouse across all its connected sources. Used to spot a sync that has quietly stopped.
List Warehouse Source Syncs Returns recent sync reports for one source connected to a warehouse.
List Warehouse Selective Syncs Returns which collections and properties actually sync from a source into a warehouse.
Update Warehouse Selective Sync Applies per-property overrides controlling which collections and properties sync into a warehouse.
Get Advanced Sync Schedule Returns the hours of day a warehouse syncs and the timezone it uses.
Replace Advanced Sync Schedule Replaces a warehouse's sync hours and timezone with a new set. This overwrites the existing schedule rather than merging into it.

Reverse ETL

List Reverse ETL Models Returns the Reverse ETL models in the workspace, each a query that extracts rows from a connected warehouse.
Get Reverse ETL Model Retrieves a single model with its query and identifier column.
Create Reverse ETL Model Creates a model that extracts rows from a warehouse source so they can be synced out to destinations.
Update Reverse ETL Model Updates a model's query, identifier column, or enabled state.
Delete Reverse ETL Model Permanently deletes a Reverse ETL model. This cannot be undone, so confirm the target first.
Create Reverse ETL Manual Sync Triggers a sync for a model and mapping now, outside its normal schedule.
Get Reverse ETL Sync Status Retrieves one sync run's status, including its extract and load phase counts.
List Reverse ETL Sync Statuses Returns recent sync statuses for a model and mapping. Used to detect a run that failed silently.
Cancel Reverse ETL Sync Cancels an in-progress sync and records the reason. Used when a model was pointed at the wrong rows.

Functions

List Functions Returns the custom functions in the workspace, optionally filtered by type.
Get Function Retrieves a single function including its source code and resource type.
Create Function Creates a custom function from JavaScript that ingests, transforms, or sends data.
Update Function Updates a function's code, settings, or description. Used to ship a new version of the logic without recreating it.
Delete Function Permanently deletes a function. Every source and destination built on it stops working, so confirm the dependants first.

Live Plugins

Get Latest Live Plugin Retrieves the latest Live Plugin for a source, including its version and download URL.
Create Live Plugin Uploads Live Plugin JavaScript for a source, creating it or replacing the existing code.
Delete Live Plugin Code Permanently deletes a source's Live Plugin code. This cannot be undone.

Tracking Plans

List Tracking Plans Returns the tracking plans that define which events and properties sources are allowed to send.
Get Tracking Plan Retrieves a single tracking plan with its type and resource schema.
Create Tracking Plan Creates a tracking plan to govern the events and properties sources may send.
Update Tracking Plan Updates a plan's name or description.
Delete Tracking Plan Permanently deletes a tracking plan and removes its validation rules, so unvalidated events start passing. This cannot be undone.

Spaces

List Spaces Returns the Engage spaces in the workspace. A space is the root scope for audiences and computed traits.
Get Space Retrieves a single Engage space by ID.

Audiences

List Audiences Returns a page of audiences in an Engage space. Used to browse audiences or resolve an audience ID.
Get Audience Retrieves a single audience with its definition query, type, and status.
Create Audience Creates an audience in an Engage space from a definition query.
Update Audience Updates an audience's name, enabled state, or definition. Used to refine the membership rule in place.
Delete Audience Permanently deletes an audience from a space. This cannot be undone, so read the definition back first.
Execute Audience Run Forces an audience to recompute now, outside its schedule. Used to refresh membership immediately after a definition change.

Audience Schedules

List Audience Schedules Returns the compute schedules on an audience. Used to check when membership last refreshed.
Get Audience Schedule Retrieves a single audience schedule with its strategy and config.
Add Audience Schedule Adds a compute schedule to an audience, either periodic or on specific days.
Update Audience Schedule Updates a schedule's strategy and config without recreating it.
Delete Audience Schedule Permanently removes a schedule, so the audience stops recomputing on it and quietly goes stale. This cannot be undone.

Audience Previews

Create Audience Preview Starts a preview computation for an audience query without creating an audience. Used to check what a rule would match before committing to it.
Get Audience Preview Retrieves a preview's status and results. Polled with the preview ID until the computation finishes.

Audience Activations

List Supported Destinations Returns the destinations and actions that support activation for an audience type. Used to discover where an audience can go.
List Audience Destinations Returns the destination connections attached to an audience.
Add Destination to Audience Connects a destination to an audience so its membership can be activated to that tool.
Update Audience Destination Updates a destination connection's identity-sync rules or connection settings.
Remove Audience Destination Permanently removes a destination connection, so the audience stops activating there. This cannot be undone.
List Activations Returns the activations configured on an audience. Used to resolve an activation ID before changing one.
Get Activation Retrieves a single activation with its type, personalization, and destination mapping.
Add Activation Adds an activation to a destination connection so membership changes are sent downstream.
Update Activation Updates an activation's enabled state, resync flag, personalization, or mapping.
Remove Activation Permanently removes an activation, so the destination stops receiving that audience's membership events. This cannot be undone.

Computed Traits

List Computed Traits Returns the computed traits in an Engage space.
Get Computed Trait Retrieves a single computed trait with its definition query and type.
Create Computed Trait Creates a computed trait in an Engage space from a definition query.
Update Computed Trait Updates a trait's name, enabled state, or definition.
Delete Computed Trait Permanently deletes a computed trait. Anything personalizing on that trait loses its input. This cannot be undone.

Space Filters

List Space Filters Returns the profile and event filters on an Engage space.
Get Space Filter Retrieves a single space filter with its condition.
Create Space Filter Creates a filter that blocks or drops events from a space's profiles.
Update Space Filter Updates a space filter's condition, enabled state, or drop behavior.
Delete Space Filter Permanently removes a space filter, so the events it was blocking reach profiles again. This cannot be undone.

Profiles Sync

List Profiles Warehouses Returns the warehouses an Engage space syncs profile data into.
Create Profiles Warehouse Connects a warehouse to an Engage space so Segment syncs profile data into it.
Update Profiles Warehouse Updates a profiles warehouse's settings, name, enabled state, or schema name.
Delete Profiles Warehouse Permanently removes a Profiles Sync warehouse from a space. This cannot be undone.
List Profiles Selective Syncs Returns which profile collections and properties sync into a warehouse.
Update Profiles Selective Sync Updates which profile collections and properties sync, including per-connector overrides.

Deletion and Suppression

List Suppressions Returns the subjects whose data is currently suppressed in the workspace.
List Workspace Regulations Returns the deletion and suppression regulations across the workspace, filterable by status or type. Used to track what has already been run.
List Source Regulations Returns the regulations scoped to one source, filterable by status or type.
Get Regulation Retrieves one regulation's status by its regulate ID, including per-stream progress. Used to confirm a run finished rather than stalled.
Create Source Regulation Runs a deletion or suppression regulation scoped to a single source. This permanently deletes or suppresses that source's data for the subject.
Create Cloud Source Regulation Runs a deletion or suppression regulation against one cloud source collection. This permanently deletes or suppresses that collection's object data.
Create Workspace Regulation Runs a deletion or suppression regulation across the entire workspace for the given subjects. The widest blast radius the connector has, and the clearest case for a human decision.

IAM Users

List Users Returns a page of workspace users. Used to browse members or resolve a user ID.
Get User Retrieves a single user with their assigned roles and resource permissions.
Add User Permissions Adds role and resource permissions to a user, leaving existing permissions in place.
Replace User Permissions Replaces all of a user's permissions with the provided set. Anything omitted is removed, so read the current set first.
List User Groups from User Returns the user groups a given user belongs to.
Delete Users Removes users from the workspace. They lose access immediately, so this belongs behind an offboarding approval.

IAM Groups

List User Groups Returns a page of workspace user groups.
Get User Group Retrieves a single user group with its member count and permissions.
Create User Group Creates a user group. Members and permissions are added afterward.
Update User Group Renames a user group.
Delete User Group Permanently deletes a user group, and with it the permissions every member inherited from it. This cannot be undone.
List Users from User Group Returns the users that belong to a group.
Add Users to User Group Adds users to a group by email, granting them the group's permissions.
Remove Users from User Group Removes users from a group by email. Those users lose the group's permissions immediately.
Replace Users in User Group Replaces the group's entire membership with the provided emails. Anyone omitted is removed.
Add User Group Permissions Adds role and resource permissions to a group, leaving existing permissions in place.
Replace User Group Permissions Replaces all of a group's permissions with the provided set. Anything omitted is revoked for every member at once.
List Invites from User Group Returns the pending invites attached to a user group.

IAM Invites and Roles

List Roles Returns the roles available to assign in permissions. Used to resolve a role before granting anything.
List Invites Returns the pending workspace invites.
Create Invites Invites one or more people to the workspace with their permissions attached.
Delete Invites Revokes pending invites by email, so the invited people can no longer accept.

Monitoring and Audit Trail

List Audit Events Returns workspace audit-trail events, filterable by time window or resource. Used to reconstruct who changed what.
Get Ingress Success Metrics Returns successfully received event counts for a source over a time window.
Get Ingress Failed Metrics Returns events a source failed to ingest. The read that catches a broken instrumentation change before anyone notices missing data.
Get Egress Success Metrics Returns successfully delivered event counts for one source and destination pair.
Get Egress Failed Metrics Returns failed delivery counts for one source and destination pair. Used to detect a destination that has started rejecting traffic.
Get Filtered At Source Metrics Returns counts of events filtered out at the source.
Get Filtered At Destination Metrics Returns counts of events filtered out at the destination. Used to check whether a filter is dropping more than it was meant to.
Get Daily Workspace API Calls Returns daily API-call usage for the whole workspace in a given month.
Get Daily Per Source API Calls Returns daily API-call usage broken down by source for a given month.

Customer Insights and dbt

Create Customer Insights Download Generates presigned download URLs for Customer Insights data for a collection and hour bucket. Data is hourly and retained for one month, so a missed window is gone.
Create dbt Model Sync Triggers a dbt model sync for a source.

Tracking (data plane)

Track Event Records an action a user or group performed, along with properties describing it. Sent to the Tracking API using the source write key.
Identify User Ties a user to their actions and records traits such as name, email, or plan.
Group User Associates a user with a company, organization, or account and records traits about that group.
Track Page View Records a website page view with optional properties about the page.
Track Screen View Records a mobile app screen view with optional properties about the screen.
Alias User Merges a previously anonymous identity with a known user ID for the same person.
Send Batch Events Sends up to 500 tracking calls in a single request. Used for backfills and high-volume replays.

Triggers

1 triggers

Event Triggers

New Audit Event Polls the Segment audit trail and fires when a new audit-trail event occurs in the workspace, such as a destructive configuration change. This is the hook for a live governance feed: a source deletion, a permission change, or a regulation run can start a review flow the moment Segment records it.

Frequently Asked Questions

What can FlowRunner do with Segment?

FlowRunner agents can run Track Event, Identify User, and Group User in Segment, plus 142 more actions.

Does connecting Segment to FlowRunner require OAuth?

No. Segment connects to FlowRunner with an API key, no OAuth flow required.

Can Segment trigger a FlowRunner workflow automatically?

Yes. Segment supports 1 trigger that can start a FlowRunner workflow automatically.

Start building with Segment

Free plan, no card required. Connect in minutes.

Start Building Free Talk to us