Segment

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
SEGMENT_PUBLIC_API_TOKENYesTwilio Segment Public API token (Workspace Settings > Access Management > Tokens) Docs.
SEGMENT_API_HOSTNoSegment Public API host without scheme: api.segmentapis.com (US, default) or eu1.api.segmentapis.com (EU workspaces).

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

ToolAccessDescription
List Sources<br /><code className="reference-identifier">segment__list_sources</code>ReadList sources
Get Source<br /><code className="reference-identifier">segment__get_source</code>ReadGet source
Create Source<br /><code className="reference-identifier">segment__create_source</code>WriteCreate source
Update Source<br /><code className="reference-identifier">segment__update_source</code>WriteUpdate source
List Destinations<br /><code className="reference-identifier">segment__list_destinations</code>ReadList destinations
Get Destination<br /><code className="reference-identifier">segment__get_destination</code>ReadGet destination
Create Destination<br /><code className="reference-identifier">segment__create_destination</code>WriteCreate destination

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.