Segment
Read Segment workspace sources, destinations, warehouses, functions, tracking plans and audit trail; enable or rename sources and destinations; manage labels and tracking plan rules.
Govern customer data pipelines: audit configuration changes, keep tracking plans in step with product analytics and report delivery health.
Source actions
21
Destination actions
8
Data types
17
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
audit events
- List audit eventsSourceIncremental
Audit trail events (configuration changes) with actor and resource.
audit_events.list
destination delivery metrics
- Get destination delivery metricsSource
Delivery success, retry, discard and latency summary for a source-destination pair.
destination_delivery_metrics.get
destination subscriptions
- List destination subscriptionsSource
Actions destination subscriptions (mappings) with trigger and enabled state.
destination_subscriptions.list
destinations
- Get destinationSource
A destination with type, enabled state and source.
destinations.get - List destinationsSource
Destinations with type, enabled state and source.
destinations.list - Update destinationDestinationProvider duplicate protectionApproval before production
Renames a destination or enables or disables delivery.
destinations.update
functions
- Get functionSource
A function with type, deployment time and setting names.
functions.get - List functionsSource
Source, destination or insert functions of one type.
functions.list
labels
- Create labelDestinationNot retried automaticallyApproval before production
Creates a workspace label.
labels.create - List labelsSource
Workspace labels (key and value) used for access control.
labels.list
source destinations
- List a source's destinationsSource
Destinations connected to a source.
source_destinations.list
source labels
- Add labels to sourceDestinationProvider duplicate protectionApproval before production
Adds existing workspace labels to a source.
source_labels.create
source warehouses
- List a source's warehousesSource
Warehouses connected to a source.
source_warehouses.list
sources
- Get sourceSource
A source with type, enabled state, labels and connected tracking plan.
sources.get - List sourcesSource
Sources with type, enabled state and labels.
sources.list - Update sourceDestinationProvider duplicate protectionApproval before production
Renames a source or enables or disables data collection.
sources.update
tracking plan rules
- List tracking plan rulesSource
Event and trait rules with their JSON Schema.
tracking_plan_rules.list - 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_rules.upsert
tracking plan sources
- Connect source to tracking planDestinationProvider duplicate protectionApproval before production
Connects a source to a tracking plan.
tracking_plan_sources.create - List tracking plan sourcesSource
Sources connected to a tracking plan.
tracking_plan_sources.list
tracking plans
- Create tracking planDestinationNot retried automaticallyApproval before production
Creates a LIVE tracking plan.
tracking_plans.create - Get tracking planSource
A tracking plan.
tracking_plans.get - List tracking plansSource
Protocols tracking plans with type and timestamps.
tracking_plans.list - Update tracking planDestinationProvider duplicate protectionApproval before production
Renames a tracking plan or changes its description.
tracking_plans.update
warehouse connection states
- Get warehouse connection stateSource
Whether Segment can connect to the warehouse.
warehouse_connection_states.get
warehouse sources
- List a warehouse's sourcesSource
Sources connected to a warehouse.
warehouse_sources.list
warehouses
- Get warehouseSource
A warehouse with type and enabled state.
warehouses.get - List warehousesSource
Warehouses with type and enabled state.
warehouses.list
workspaces
- Get workspaceSource
The workspace the token belongs to.
workspaces.get
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. Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- Sending tracking calls (identify, track, page) uses the Tracking API on api.segment.io with source write keys in Basic auth, a different host and credential; it is not available on this connection.
- Write keys and destination or function setting values are never returned, because they can contain secrets; only their names or counts are mapped.
- Creating, deleting or reconfiguring sources, destinations, warehouses and functions (settings) is not implemented.
- Tracking plan rules can be added or updated but not replaced wholesale or deleted.
- 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.