Automations

​

Try It In The Dashboard

• Use it as a flow builder. Click a flow together, and the API definition panel next to it shows the exact definition JSON this API expects, with the real IDs from your team. Copy it into your POST /api/v1/automations or PATCH call and you’re done.
• Watch it run. The execution logs show every run and what each step did, the same data as Testing & Execution Logs.
• Ice breakers and the persistent menu can be set up there too.
• It’s the same data either way: flows created through the API show up in the dashboard, and the other way around.

​

In This Section

​

All Endpoints

​

Which Tool Do I Need?

​

Supported Platforms

​

Plans And Limits

• One run = one flow reacting to one comment or message, no matter how many steps it has.
• Runs that stop at a condition, get skipped by a safety limit (see Safety Limits), or get canceled don’t count.
• Runs that fail do count, and so do test runs, since they really send messages.
• DMs sent by automations also count toward the account’s monthly message quota.
• When the budget runs out, new runs are recorded as SKIPPED with the code AUTOMATION_MONTHLY_LIMIT_REACHED. Quotas reset on the 1st of every month (UTC).

​

Before You Start

1. Reconnect your Facebook and Instagram accounts with withMessagingScope: true. This covers accounts that were already connected before the switch. Until they are reconnected they have no messaging permissions, and we don’t receive their new comments either, so no flow on them can ever fire.
2. Subscribe each account to messages with POST /api/v1/social-account/messaging/enable. This registers it for Meta’s message webhooks. It’s needed for any flow that reacts to DMs or button taps, or sends DMs or private replies. A flow that only replies publicly or likes comments works without it. Both steps are two API calls, see Direct Messages → Setup.
3. TikTok accounts need comment management permissions. A regular TikTok connection has them. If publishing a flow complains about permissions, reconnect the account. Also give every TikTok flow a 5-10 second delay.
4. Comment flows only work on posts published through bundle.social on that account. You point the flow at one with postId.
5. Your webhook endpoint accepts the new events (see Webhooks).

​

Where The IDs Come From

​

How It Works

Trigger: someone comments "link" on post_123 (Instagram)
  → Step 1: send them a private reply with the link
  → Step 2: reply publicly "Check your DMs 👀"

1. Trigger. An event arrives: a new comment, a new DM, or a tap on a button or quick reply. We look for published, active flows whose trigger matches it.
2. Run. Each matching flow gets its own execution (a run). If the trigger has a delay, the run waits for it.
3. Steps. Steps run top to bottom. A CONDITION step that doesn’t match stops the run right there.
4. Log. Every run and every step is recorded, with inputs, outputs and errors. That’s your debugging tool, see Executions.

​

Drafts And Publishing

​

Capabilities By Platform

​

Triggers

​

Steps

​

Which Steps Fit Which Trigger

• SEND_PRIVATE_REPLY, SEND_PUBLIC_COMMENT_REPLY and LIKE_COMMENT need a COMMENT_CREATED trigger. There’s no comment to reply to otherwise.
• SEND_MESSAGE needs a DM_RECEIVED, QUICK_REPLY_CLICKED or BUTTON_CLICKED trigger. To DM a commenter, use SEND_PRIVATE_REPLY. Meta doesn’t allow any other message until they answer it.
• ARCHIVE_CONVERSATION / OPEN_CONVERSATION need a DM or click trigger, or a SEND_PRIVATE_REPLY earlier in the flow (that’s what creates the conversation).
• Every flow needs at least one step that actually does something (not only conditions).

​

Quick FAQ

​

”My flow is ACTIVE but nothing happens.”

1. Was the account reconnected after your organization was allowlisted? Accounts connected earlier don’t send us comments or DMs. See Before You Start.
2. Is it a comment flow? The post in postId must be published through bundle.social on the same account.
3. Did you edit it after publishing? Edits are drafts until you publish again.
4. Do the keywords really match? They match whole words: "link" won’t match “links”.
5. Look at the executions. If runs are there as SKIPPED, error.code tells you why. No error means a condition stopped the run, output.skippedAtStepId says which one.
6. No executions at all for a DM flow? Make sure the account is subscribed with messaging/enable (Direct Messages → Setup).
7. Still no executions? While automations are paused on our side (for example during a platform incident), incoming events don’t create runs at all, so nothing shows up in the logs.

​

”Can one comment or message trigger several flows?”

​

”Why did someone get two replies to one message?”

​

”Why did my automation ignore someone’s second message?”

​

”My TikTok flow sometimes fails on the reply or like step.”

​

”Can one flow cover all my posts?”

​

”Can I stop automations for one conversation when a human takes over?”

​

”How do I reply to a comment by hand?”

​

”Can I DM everyone who commented, not just reply?”

​

”Does it work on posts I didn’t publish through bundle.social?”

​

”Is there a visual flow builder?”