Segment
Send events, user identifications, and group data to Segment for customer data routing. Use SignalSmith to push warehouse data into your Segment pipeline.
Prerequisites
- A Segment account
- A Segment source Write Key
Authentication
Segment uses Write Key authentication.
- In Segment, go to Connections > Sources
- Create or select a source (e.g., HTTP API source)
- Copy the Write Key from the source settings
- Paste it into the Write Key field in SignalSmith
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Data Center | Select | Yes | Segment data center: United States or European Union. Default: US |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Event Type | Select | Yes | Type of Segment API call: Identify (user traits), Track (events), or Group (company/org traits) |
Supported Operations
Sync Modes: Upsert, Insert
Audience Sync Modes: Add, Upsert
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Event Type | Required Fields |
|---|---|
| Identify | user_id |
| Track | user_id, event |
| Group | user_id, group_id |
Default Destination Fields
Identify: user_id, anonymous_id, email, name, phone
Track: user_id, event, properties, timestamp
Group: user_id, group_id, traits
Troubleshooting
Invalid Write Key
Ensure the Write Key is from a valid Segment source. The source must be enabled and not archived.
Events not flowing to downstream destinations
Verify that your Segment source has downstream destinations connected and enabled. Check the Segment Debugger for incoming events.
Wrong data center
US and EU workspaces have different endpoints. Ensure you selected the correct data center.