Comment triggers

Create a comment trigger

Creates a trigger. It goes live at once unless the plan's live-trigger cap is reached, in which case it is saved paused and created_paused is true (never refused). Buttons are optional, up to three. A reply button is still worth adding: its tap opens the conversation so follow-ups can be sent. Story and Live triggers are Instagram only and never post-scoped. Send draft: true to save an incomplete trigger paused, skipping the template and button requirements. Requires the write scope.

post/comment-triggers

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/comment-triggers
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Request body

namestring required
platform'instagram' | 'facebook' | 'both'
source_type'comment' | 'story' | 'both' | 'live'

comment = post and Reel comments; story = replies to your stories; both = either; live = comments during an Instagram Live. story and live are Instagram only.

post_idstring nullable

Scope to one post (an id from GET /recent-posts). Null means every post. Ignored for story and live.

post_urlstring nullable

Label only; post_id is what scopes the trigger.

keywordsstring[] required

Any one of these matches.

match_type'exact' | 'contains' | 'fuzzy'

exact = whole word; contains = anywhere in the text; fuzzy = tolerates a typo or two.

exclude_keywordsstring[]

If any of these appear the trigger does not fire.

response_mode'both' | 'public_only' | 'dm_only'

both = public reply and DM; public_only; dm_only.

public_repliesstring[]

Up to five variations, one is picked per fire. {name} is the commenter. Required when the mode includes a public reply.

dm_templatesstring[]

Up to five DM variations. Required when the mode includes a DM unless dm_use_ai is true.

dm_use_aiboolean

Let the AI write the DM from dm_ai_goal, the knowledge base and the configured tone. Needs dm_ai_goal.

dm_ai_goalstring nullable

What the AI-written DM should achieve.

dm_image_urlstring nullable

https image attached to the DM.

dm_file_urlstring nullable

https PDF attached to the DM.

hide_comment_after_dmboolean

Hide the comment once the DM is sent (post comments only).

tag_idinteger nullable

Tag applied to the commenter when the trigger fires. Pro plans and above; silently ignored below.

draftboolean

Save incomplete, paused. Skips the template and button requirements.

Response

201 created

Changes

No recorded changes to this operation across all 1 revision of this API.