Segment
Bring your business data together in Segment, and act on it in the apps your team already uses.
52 ways to read, 8 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Segment, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create labelApproval by rule
- Add labels to sourceApproval by rule
- Get daily API call usageRead
Example flow
- Segment · Get daily API call usageDone
- Segment · Create labelNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Segment.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Segment
- Segment's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read Segment sources, destinations, filters, warehouses and syncs, catalog, usage, event volume, Unify spaces, audiences, traits, Reverse ETL and audit trail; manage labels, tracking plans and rules.
Twilio API docs- Source actions
- 52
- Destination actions
- 8
- Data types
- 38
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
API call usage1
- Get daily API call usageSource
Daily workspace API call counts for a usage month.
Audiences2
- Get audienceSource
One audience with its definition, size and compute cadence.
- List audiencesSource
Engage audiences in a space with definition, status, size and compute cadence.
Audit events1
- List audit eventsSourceIncremental
Audit trail events (configuration changes) with actor and resource.
Computed traits2
- Get computed traitSource
One computed trait with its definition.
- List computed traitsSource
Computed traits in a space with definition and status.
Destination catalog2
- Get destination catalog entrySource
One destination type with its options and Actions.
- List destination catalogSource
Destination types with supported methods, platforms, options and Actions.
Destination delivery metrics1
- Get destination delivery metricsSource
Delivery success, retry, discard and latency summary for a source-destination pair.
Destination filters2
- Get destination filterSource
One destination filter with its condition and actions.
- List destination filtersSource
Filters that drop, sample or trim events before they reach a destination.
Destination subscriptions2
- Get destination subscriptionSource
One Actions destination subscription (mapping) with its trigger.
- List destination subscriptionsSource
Actions destination subscriptions (mappings) with trigger and enabled state.
Destinations3
- Get destinationSource
A destination with type, enabled state and source.
- List destinationsSource
Destinations with type, enabled state and source.
- Update destinationDestinationProvider duplicate protectionApproval before production
Renames a destination or enables or disables delivery.
Event volume1
- Get event volumeSource
Event counts over time for the workspace, optionally by source, event name or type.
Function versions1
- List function versionsSource
Saved versions of a function with author and deployment state (code is not returned).
Functions2
- Get functionSource
A function with type, deployment time and setting names.
- List functionsSource
Source, destination or insert functions of one type.
Insert function instances1
- List insert function instancesSource
Where an insert function is attached, with enabled state (settings are not returned).
Labels2
- Create labelDestinationNot retried automaticallyApproval before production
Creates a workspace label.
- List labelsSource
Workspace labels (key and value) used for access control.
Mtu usage1
- Get daily MTU usageSource
Daily monthly-tracked-user counts (anonymous, identified) for a usage month.
Reverse etl models2
- Get Reverse ETL modelSource
One Reverse ETL model.
- List Reverse ETL modelsSource
Reverse ETL models with their SQL query and identifier column.
Reverse etl syncs1
- Get Reverse ETL sync statusSource
Status, timing and extract and load results of one Reverse ETL sync.
Selective syncs1
- List selective sync settingsSource
Collections and properties enabled for syncing from a source to a warehouse.
Source API call usage1
- Get daily API call usage by sourceSource
Daily API call counts per source for a usage month.
Source catalog2
- Get source catalog entrySource
One source type with its setting options.
- List source catalogSource
Source types Segment offers, with categories and setting options.
Source destinations1
- List a source's destinationsSource
Destinations connected to a source.
Source labels1
- Add labels to sourceDestinationProvider duplicate protectionApproval before production
Adds existing workspace labels to a source.
Source mtu usage1
- Get daily MTU usage by sourceSource
Daily monthly-tracked-user counts per source for a usage month.
Source schema settings1
- Get source schema settingsSource
Protocols schema controls for a source: unplanned events, traits and violation handling.
Source warehouses1
- List a source's warehousesSource
Warehouses connected to a source.
Sources3
- Get sourceSource
A source with type, enabled state, labels and connected tracking plan.
- List sourcesSource
Sources with type, enabled state and labels.
- Update sourceDestinationProvider duplicate protectionApproval before production
Renames a source or enables or disables data collection.
Spaces2
- Get Unify spaceSource
One Engage or Unify space.
- List Unify spacesSource
Engage and Unify spaces in the workspace.
Tracking plan rules2
- List tracking plan rulesSource
Event and trait rules with their JSON Schema.
- Add or update tracking plan ruleDestinationProvider duplicate protectionApproval before production
Inserts or updates one rule (event or trait JSON Schema) in a tracking plan.
Tracking plan sources2
- Connect source to tracking planDestinationProvider duplicate protectionApproval before production
Connects a source to a tracking plan.
- List tracking plan sourcesSource
Sources connected to a tracking plan.
Tracking plans4
- Create tracking planDestinationNot retried automaticallyApproval before production
Creates a LIVE tracking plan.
- Get tracking planSource
A tracking plan.
- List tracking plansSource
Protocols tracking plans with type and timestamps.
- Update tracking planDestinationProvider duplicate protectionApproval before production
Renames a tracking plan or changes its description.
Transformations2
- Get transformationSource
One transformation with its condition and changes.
- List transformationsSource
Event transformations (renames, drops, property changes) applied at sources or destinations.
Warehouse catalog2
- Get warehouse catalog entrySource
One warehouse type with its setting options.
- List warehouse catalogSource
Warehouse types with setting options.
Warehouse connection states1
- Get warehouse connection stateSource
Whether Segment can connect to the warehouse.
Warehouse source syncs1
- List warehouse syncs for a sourceSource
Sync reports for one source connected to a warehouse.
Warehouse sources1
- List a warehouse's sourcesSource
Sources connected to a warehouse.
Warehouse syncs1
- List warehouse syncsSource
Recent sync reports for a warehouse with status, duration and row counts.
Warehouses2
- Get warehouseSource
A warehouse with type and enabled state.
- List warehousesSource
Warehouses with type and enabled state.
Workspaces1
- Get workspaceSource
The workspace the token belongs to.
Access and limits
- Authentication
- Public API token (bearer)
- Plans and access
- Public API access is available to Team and Business workspaces; Protocols (tracking plans) and the audit trail need Business tier. Public API tokens are created by workspace owners and carry the token's role permissions.
- Test environment
- A free or trial workspace can be used for read testing.
- Rate limits
- Per-token, per-endpoint limits (for example 200 requests per minute for tracking plan rules); HTTP 429 with rate limit headers.
- Pagination
- pagination.count and pagination.cursor; data.pagination.next gives the next cursor.
- Provider events
- Segment audit trail forwarding and destinations, not configured through this API. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Tracking calls (identify, track, page, screen, group, alias, batch) and Unify profile reads use different hosts and credentials (source write key, Profile API access token); they are available through the separate Segment (Tracking & Profiles) connector (segment-tracking), not on this connection.
- The Profiles API (profiles.segment.com, a separate Space access token) is not used, so user profile traits, events and identities cannot be read here.
- Write keys, destination, subscription, function and insert function setting values, and function source code are never returned, because they can contain secrets; only their names or counts are mapped.
- Creating, deleting or reconfiguring sources, destinations, warehouses, functions, transformations and destination filters (which can drop or alter live event data) is not implemented. Write keys are never created or removed.
- Audience, computed trait and Reverse ETL writes are not implemented: they activate syncs to downstream tools. Manual Reverse ETL syncs, audience runs and previews are never triggered.
- Deletion and suppression regulations, IAM users, groups and roles, and Delivery Overview (beta) metrics are out of scope.
- Tracking plan rules can be added or updated but not replaced wholesale or deleted.
- Spaces, computed traits, Reverse ETL, destination subscriptions and function versions are alpha endpoints and delivery metrics is a beta endpoint in Segment's API; Nexra sends the matching versioned Accept header.
- Event volume accepts one group-by dimension and one value per filter, because Nexra does not send repeated query parameters.
- Label creation has no idempotency key; uncertain writes are not repeated automatically.
Developer reference
- Create the Twilio credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Segment, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/segment and the Connections API.