--- title: Segment API Integration on Truto slug: segment category: Marketing Automation canonical: "https://truto.one/integrations/detail/segment/" --- # Segment API Integration on Truto **Category:** Marketing Automation **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## How it works 1. **Link your customer's Segment account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Segment.** The Proxy API is a 1-to-1 mapping of the Segment API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync Segment workspace structure into your multi-tenant app** — If your SaaS organizes customers by accounts, teams, or workspaces, you can pull Segment's workspace, group, and user hierarchy into your product to automatically mirror your end-user's organizational structure without manual setup. - **Push product events into your end-users' Segment pipelines** — Your SaaS generates valuable events (e.g., survey completions, invoice payments, feature usage). By integrating with Segment, you let end-users route those events to their own data warehouses, CRMs, and analytics tools without any custom code on their side. - **Ingest real-time user behavior data from Segment** — Instead of asking customers to install another SDK, your product can receive Track, Identify, and Group calls directly from Segment — giving you rich behavioral data to power features like account health scoring, personalization, or usage-based billing. - **Automate user provisioning based on Segment workspace membership** — When end-users connect their Segment account, your app can read workspace members, roles, and groups to auto-provision users and assign permissions, reducing onboarding friction for team-based products. - **Enrich your product's user profiles with Segment identity data** — Pull unified user traits and group associations from Segment to augment your own user records, enabling richer segmentation, smarter defaults, and more relevant in-product experiences. ## What you can build - **Automatic workspace and team import** — Let end-users connect Segment and instantly import their workspace hierarchy — including groups, users, and roles — so your product mirrors their org structure on day one. - **Event forwarding to Segment** — Ship a native 'Send to Segment' toggle that pushes your product's events (Track and Identify calls) into the end-user's Segment workspace using their Write Key. - **Role-based access sync** — Map Segment workspace roles to permission levels in your app so that admins, read-only users, and collaborators get the right access automatically. - **Group-aware account dashboards** — Use Segment's Group associations to build account-level views in your product, showing aggregated metrics and health scores per organization rather than per individual user. - **Self-serve Segment connection via embedded auth** — Embed Truto's auth flow so end-users can securely connect their Segment account from inside your app — no API keys copy-pasted over Slack. ## FAQs ### What authentication method does the Segment integration use? Segment's Public API uses OAuth 2.0 or personal access tokens for workspace-level operations. Truto handles the auth flow so your end-users can connect their Segment account without you managing token exchange or refresh logic. ### Which Unified API does this integration map to? Segment maps to Truto's Unified User Directory API, which provides standardized access to Groups, Roles, Users, and Workspaces. This lets you read and sync Segment's organizational structure using a consistent schema. ### Are there specific Truto tools available for Segment today? Segment tools are built on request. If you need specific API operations beyond what the Unified User Directory covers — such as Tracking API calls or Source/Destination management — contact Truto and they'll scope and build them for your use case. ### How does Truto handle Segment's rate limits? Truto manages rate limiting, retries, and pagination automatically. Segment's Public API enforces rate limits per workspace and per token; Truto respects these limits and queues requests so your integration doesn't hit throttling errors. ### Can I use this integration to send Track or Identify events to Segment? Segment's Tracking API (Track, Identify, Group, Page, Screen, Alias) is a core part of the product. While specific Truto tools for these methods are built on request, the underlying API fully supports pushing events programmatically using a workspace's Write Key. ### What data can I read from Segment through the Unified User Directory API? You can read workspace members (Users), their assigned roles (Roles), group associations (Groups), and workspace metadata (Workspaces). This gives you the organizational context needed to provision users and mirror team structures in your product.