Segment

​

At a glance

• Availability: Experimental (how to enable).
• Authentication: API key.
• Connection: The key comes from SEGMENT_PUBLIC_API_TOKEN.
• Provider documentation: Authentication reference.

​

Credentials

Set these per environment. See Connect an integration.

​

Setup

1. Sign in to Segment: Go to https://app.segment.com and sign in. A free workspace is sufficient for testing.
2. Create a Public API token: Open Workspace Settings > Access Management > Tokens and select Create Token. Choose the Public API token type (not the legacy Config API) and grant Workspace Member or Owner scope as needed. Copy the token immediately: it is shown only once.
3. Set the environment variable: Add the token to your .env as SEGMENT_PUBLIC_API_TOKEN=…
4. Verify access: Run List Sources. EU-hosted workspaces must set SEGMENT_API_HOST=eu1.api.segmentapis.com in .env first; US workspaces can keep the default api.segmentapis.com.

​

Provider notes

• The Public API authenticates with ‘Authorization: Bearer <token>’
• US workspaces use api.segmentapis.com (the default); EU workspaces set SEGMENT_API_HOST=eu1.api.segmentapis.com
• Creating sources/destinations needs a catalog metadataId from the /catalog endpoints

Provider API reference.

​

Tools

​

Verify the connection

Call a read tool such as segment__list_sources with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.