segment

Troubleshooting

If requests fail, run zero doctor check-connector --env-name SEGMENT_TOKEN or zero doctor check-connector --url "https://api.segmentapis.com/echo?message=ok" --method GET.

Official Docs

• Public API docs: https://docs.segmentapis.com/
• Sources: https://docs.segmentapis.com/tag/Sources/
• Destinations: https://docs.segmentapis.com/tag/Destinations/
• Tracking Plans: https://docs.segmentapis.com/tag/Tracking-Plans/

Authentication

Connect the Segment connector at app.vm0.ai/connectors. The connector provides:

• SEGMENT_TOKEN: Segment Public API token

All requests use bearer auth:

Authorization: Bearer $SEGMENT_TOKEN

Base URL:

https://api.segmentapis.com

Connectivity Test

Use the echo endpoint to confirm token and firewall wiring:

curl -s "https://api.segmentapis.com/echo?message=ok" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Sources

List Sources

curl -s "https://api.segmentapis.com/sources" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Get a Source

curl -s "https://api.segmentapis.com/sources/<source-id>" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

List Connected Destinations for a Source

curl -s "https://api.segmentapis.com/sources/<source-id>/connected-destinations" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Destinations

List Destinations

curl -s "https://api.segmentapis.com/destinations" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Get a Destination

curl -s "https://api.segmentapis.com/destinations/<destination-id>" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

List Destination Delivery Metrics

curl -s "https://api.segmentapis.com/destinations/<destination-id>/delivery-metrics" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Tracking Plans

List Tracking Plans

curl -s "https://api.segmentapis.com/tracking-plans" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Get a Tracking Plan

curl -s "https://api.segmentapis.com/tracking-plans/<tracking-plan-id>" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

List Tracking Plan Rules

curl -s "https://api.segmentapis.com/tracking-plans/<tracking-plan-id>/rules" \
  --header "Authorization: Bearer $SEGMENT_TOKEN" | jq .

Guidelines

• This connector uses Segment Public API tokens for workspace configuration. It does not provide HTTP Tracking API write keys.
• Public API access is permission-scoped. A 403 usually means the token lacks permission for that resource.
• Use read endpoints first to discover source, destination, and tracking plan IDs before making updates.
• Treat source write keys, destination settings, warehouse settings, and delivery metrics as sensitive data.