Skip to main content
POST
Beta. See the Automations Overview for the full feature description, including the Beta status.
Create a new automation that fires one or more actions when any of its triggers matches. The automation activates immediately. See the Overview for the full catalog of triggers, actions, template variables, and limits. The connected Instagram account or Facebook Page is derived server-side from the caller’s linked profile — do not pass accountId in the body; the request will be rejected as a validation error if you do. Pass a profileKey header to operate under a child profile.

Header Parameters

Body Parameters

string
required
Target platform: instagram or facebook (the linked Facebook Page). Facebook supports the dm_keyword and dm_reaction triggers. See Facebook Pages.
string
required
Short human-readable name. Used in the dashboard and activity logs.
string
Optional longer description.
array
required
One or more triggers (1–50). Each entry is a discriminated union on type. See Overview / Triggers for the full catalog.
comment_keyword trigger
comment_keyword trigger — every post (evergreen)
story_reply trigger
dm_reaction trigger
dm_keyword trigger
array
required
One or more actions (1–50). Each entry is a discriminated union on type. See Overview / Actions for the full catalog. Every action also accepts an optional top-level dedupWindowMinutes overriding the default 7-day per-recipient dedup window (0 to disable, max 525600).
send_dm action
fire_webhook action
send_email action
Action with per-action dedup override
Platform compatibility. Each trigger and action declares which platforms it supports. The validator rejects the request when an entry’s type is not supported on the requested platform. All triggers support Instagram; dm_keyword and dm_reaction also support Facebook. send_dm supports both, fire_webhook and send_email are platform-agnostic.