Automations

Returns the comment-to-DM automations of the workspace, newest first. An automation answers a keyword in an Instagram comment (or a DM, or a story reply) with a DM, once per person. Needs the opt-in automations:read scope.

Creates a comment-to-DM automation on the connected Instagram account. When somebody comments a keyword on the post (or sends it in a DM / story reply, see trigger.kinds), the account sends them actions.dm.text as a private message, once per person, and optionally posts one of actions.public_reply.variations under the comment. Instagram rules: one private reply per comment, within 7 days of the comment; a follow-up is only possible after the person answers (24-hour window). OmniSocials caps sends at 180 DMs an hour per account. For scope post, pass post_id (an OmniSocials post that goes to Instagram; a scheduled post starts listening once it is live) or instagram_media_id (a post published outside OmniSocials). Needs the opt-in automations:write scope and a connected Instagram account.

Deletes the automation and its activity log. DMs that were already sent stay sent.

Partial update. status pauses (paused) or resumes (active) the automation. trigger, actions and limits are merged into the stored sections: keys you omit keep their value (new keywords keep the kinds, the scope and the match; a new dm.text keeps the public reply). public_reply.variations: [] or enabled: false turns the public reply off; limits.max_sends: null removes that limit. Another post_id or instagram_media_id moves the automation to that post. A completed automation starts again when its limits or trigger change.

One row per comment or message the automation acted on, newest first: the DM that was sent, a skip with its reason, or a failure with the platform's error. counts gives the total per outcome.