Update an activity (partial); set status to activate or pause
Request
- Base URLhttps://social-automation.cresclab.com/api/v1
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
Request body
ig_comment (instagram): A comment on an Instagram post or Reel. ig_story (instagram): A reply to (or mention in) an Instagram Story. post_ids, if set, are story ids. ig_live (instagram): A comment during an Instagram Live broadcast (only while the broadcast is live). ig_message (instagram): An Instagram DM sent to the account. dm_source "keywords" (default) answers DMs that match a keyword; dm_source "ads" answers only the first DM of a conversation opened from an ad (live video ads, click-to-Instagram-Direct ads), keywords optional. fb_comment (facebook): A comment on a Facebook Page post. The DM is sent through Messenger. fb_live (facebook): A comment during a Facebook Live broadcast (only while the broadcast is live). fb_message (facebook): A Messenger message sent to the Page; the activity replies in Messenger. dm_source "ads" answers only conversations opened from an ad (live video ads, click-to-Messenger ads). threads_reply (threads): A reply to a Threads post. Public reply only: Meta offers no Threads DM API. Meta allows up to 1,000 replies per Threads profile per 24 hours.
Internal name shown in the dashboard.
Keywords that trigger the activity, e.g. ["+1", "want", "price"]. Case-insensitive. Empty array = every comment triggers it. ig_message needs at least one keyword unless dm_source is "ads".
ig_message and fb_message only. "keywords" (default): answer DMs that match a keyword. "ads": answer only the first DM of a conversation opened from an ad (Instagram/Facebook live video ads with a message button, click-to-Instagram-Direct or click-to-Messenger ads); keywords are optional and narrow it further.
"contains" (default): comment contains a keyword. "exact": comment equals a keyword.
Public replies posted under the comment; one is picked at random each time (avoids looking like spam). Not available for ig_story and fb_message.
"all" (default): every post. "selected": only post_ids. "next_post": the next Instagram post you publish (ig_comment only).
Post ids from list_recent_posts, or full post URLs (Instagram/Threads URLs are resolved to ids, which needs a live Meta call).
Optional start time, ISO 8601 with timezone (e.g. 2026-10-10T20:00:00+08:00).
Optional end time, ISO 8601 with timezone. Must be after start_at.
Response
OK
ig_comment (instagram): A comment on an Instagram post or Reel. ig_story (instagram): A reply to (or mention in) an Instagram Story. post_ids, if set, are story ids. ig_live (instagram): A comment during an Instagram Live broadcast (only while the broadcast is live). ig_message (instagram): An Instagram DM sent to the account. dm_source "keywords" (default) answers DMs that match a keyword; dm_source "ads" answers only the first DM of a conversation opened from an ad (live video ads, click-to-Instagram-Direct ads), keywords optional. fb_comment (facebook): A comment on a Facebook Page post. The DM is sent through Messenger. fb_live (facebook): A comment during a Facebook Live broadcast (only while the broadcast is live). fb_message (facebook): A Messenger message sent to the Page; the activity replies in Messenger. dm_source "ads" answers only conversations opened from an ad (live video ads, click-to-Messenger ads). threads_reply (threads): A reply to a Threads post. Public reply only: Meta offers no Threads DM API. Meta allows up to 1,000 replies per Threads profile per 24 hours.
Changes
No recorded changes to this operation across all 1 revision of this API.