Skip to main content
POST
Propose a reply automation, a creator's DM automation: a keyword in a comment, story reply or DM sends one message as the creator with a link, tracked unless the creator says otherwise, once per person, off until the creator flips its switch. Ask for a missing keyword; every other field has a default the board shows.

Authorizations

Authorization
string
header
required

A WorkOS-dashboard-issued internal API key on Authorization: Bearer.

Body

application/json
keywords
string[]
required

The words that fire the reply, one to ten, each one word; a trigger carrying any of them as a whole word, in any case, is answered. No word may answer twice on one surface while both rules are on. When the creator names no word, ask which one should fire it before proposing, offering the word the reel's caption calls for when it names one; never invent a word.

Required array length: 1 - 10 elements
Required string length: 1 - 64
Pattern: ^[^\s<>]+$
message
string
required

The one line Dally sends as the creator, at most 800 Unicode code points; the link and the disclosure are added after it. When the creator gives no line, write one short line that offers what the reel promises and say it is yours; the board shows it and automation.edit changes it.

Required string length: 1 - 800

Where the link lands; https only. Default: Dally's home page.

content_ids
string<uuid>[]

The posts a comment listens on and the stories a story reply listens on, from content.content_id; empty means any of the creator's. The creator's latest post is their newest content row by published_at. Ignored on the dm surface.

Maximum array length: 50
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
surfaces
enum<string>[]

Which surfaces fire it, one to three: comment, story_reply, dm. Default: all three. A creator's 'DM automation' names where the reply lands, always the DMs, not the surface that fires it.

Required array length: 1 - 3 elements

comment: a comment on one of the automation's posts (reel, image or album), or on any of the creator's posts, answered in the commenter's DMs. story_reply: a reply to one of the automation's stories or highlights, or to any of the creator's stories, answered in that thread. dm: a DM carrying a keyword, answered in that thread.

Available options:
comment,
story_reply,
dm

true: the link is sent as dally.ai/r/, so taps, visits and sales are counted per person; false: the link is sent as typed and only sends and reads are counted

follow_ups
object

One more message per later step the person takes — signed up, connected, purchased — each sent once in the same Instagram thread as the creator, and only while Instagram's reply window is still open; nothing is ever queued for later.

Response

Success. request_id is present on every response.

rule
object
required

One reply automation: its surfaces, its posts and stories or any of them, its keywords, the one line Dally sends as the creator with the link and the disclosure, where it stands, and its counts.

show
object
required

How it is shown: dally_write renders this kind on this very answer, so the creator already sees the board; do not render it again. The board reads the creator's automations itself and takes no rows from you.

request_id
string
required

Server-minted id for this request. Present on every response, success and error — quote it when reporting a problem.

Minimum string length: 1