Automations and Webhooks

Trigger automations and manage webhook subscriptions from the terminal.

fopost automations drives existing automations; fopost webhooks manages outbound webhook subscriptions. Creating and editing automations themselves happens in the dashboard.

Automations

fopost automations list
fopost automations get auto_42
fopost automations toggle auto_42       # flip active on or off
fopost automations runs auto_42         # run history, with --page / --per-page

toggle is the only switch: there is no separate enable and disable pair.

Trigger

An automation whose trigger is an API webhook can be fired directly, with a JSON payload:

fopost automations trigger auto_42 --payload '{"source":"ci","sha":"abc123"}'
fopost automations trigger auto_42 --payload @payload.json
fopost automations trigger auto_42 --payload -          # read stdin

The payload must be a JSON object; empty means {}. The command prints the started run's id, and runs shows how it went.

Webhooks

fopost webhooks list
fopost webhooks create --url https://yourbrand.com/hooks/fopost \
  --event post.published --event delivery.failed
fopost webhooks test wh_7f3e
fopost webhooks delete wh_7f3e --yes

create requires a workspace, --url, and at least one --event. The event names are listed in Webhook Events. The signing secret is printed once, at creation. Store it then; it cannot be shown again.

list shows each subscription's URL, events, active state, and failure count. test sends a sample delivery. See how test deliveries behave before relying on it.

Next

Related documentation
  • CLI

    Schedule, publish, and inspect FoPost content from your terminal, as a single static binary.

  • Posts

    Create, schedule, publish, and inspect posts from the terminal.

  • Accounts and Workspaces

    Inspect connected accounts, their health, and your workspaces.

  • Media and Labels

    Manage library assets and campaign labels from the terminal.

  • Analytics

    Read cross-account performance numbers without leaving the terminal.

  • Scripting

    JSON output, exit codes, and shell completion for automation.

  • Automations

    Rules that publish for you, with a run log and a circuit breaker.

  • Webhooks

    Hear about publishing outcomes and account health without polling.

Was this helpful?

On this page