---
name: "Marketing: Segment"
description: Customer data platform for collecting, routing, and activating user data. Run it via run_marketing_tool (tool="segment").
version: 1
situations: analytics, segment
requires-secrets: SEGMENT_WRITE_KEY, SEGMENT_ACCESS_TOKEN
requires-packages:
---

# Marketing: Segment (Analytics)

Customer data platform for collecting, routing, and activating user data.

Call the `run_marketing_tool` tool with `tool: "segment"` and `args: [...]` — args is the same
`{resource} {action} [--flag value ...]` shape as the CLI itself. Output is JSON on stdout.

Example: `run_marketing_tool` with `tool="segment"`, `args=["--help"]`.

Use `--dry-run` on any command to preview the request without sending it. Full command reference (every resource/action/flag): [reference.md](reference.md).

Needs the secret(s) `SEGMENT_WRITE_KEY, SEGMENT_ACCESS_TOKEN` set in the vault (Secrets UI) — ask the operator to add them if
`run_marketing_tool` reports they're missing.
