Manage automations, funnels & segments

Most CLI commands only read analytics. These write to your site, so double-check the flags before running one — there's no undo for a delete.

Automation alerts

trackfox automation show
trackfox automation discord --webhook-url https://discord.com/api/webhooks/... --events payment,signup --enable
trackfox automation telegram --bot-token 123:abc --chat-id 456 --events payment --enable

show prints the current Discord/Telegram config without exposing the stored bot token. --events takes a comma-separated list of event names; --enable/--disable and --mute/--unmute toggle delivery without touching the rest of the config. Fields you don't pass are left as they were — you don't have to resend the webhook URL just to change --events.

See Discord automations and Telegram automations for what each event type looks like when it arrives.

Funnels

trackfox funnel list
trackfox funnel create --name "Signup" --steps '[{"stepType":"pageview","urlPattern":"/pricing"},{"stepType":"event","eventName":"signup"}]'
trackfox funnel delete <id>

--steps is a JSON array of 2–10 steps, each { stepType: "event" | "pageview", eventName or urlPattern, displayName? }. Optional --description and --time-window <hours> match the funnel builder in the dashboard.

Saved segments

trackfox segment list
trackfox segment create --name "Power users" --filters '[{"type":"custom-event","label":"signup","value":"signup"}]'
trackfox segment delete <id>

--filters is a JSON array of { type, label, value } objects matching the dashboard's filter bar. A website can hold up to 20 saved segments.

Attribute a server-side payment

trackfox attribute-payment --session-id <id> --visitor-id <id> --revenue 9900 --email customer@example.com

Creates a payment event and attaches it to an existing visitor session — the terminal equivalent of the Attribute Payment API. --revenue is an integer number of cents.

Export JSON

Every command above accepts --output json, same as the read commands:

trackfox funnel list --output json