Skip to main content
Connectly campaigns let you trigger a full message flow — multiple steps, interactive buttons, conditional branching, and time delays — to a list of recipients in one API call. You build the flow visually in the Flow Builder, then kick off sendouts by passing the campaignName to the Campaigns API.

​
How it works

1

Create your campaign

Go to inbox.connectly.ai and click Create new Campaign. Follow the steps in the wizard and send the campaign to yourself to verify it works.
2

Build your flow in the Flow Builder

Go to inbox.connectly.ai and click Create new Campaign. Design your message sequence — add steps, buttons, and branching logic — then send a test to your own WhatsApp number to verify it works end-to-end.
3

Open the Flow Builder

After a successful test send, navigate back to the Flow Builder section of the inbox.
4

Copy the campaign name

Select Resend or Edit next to your campaign. The name displayed is your campaignName — copy it exactly as shown.
5

Find your campaign name

Once your test send succeeds, go back to the Flow Builder, select Resend or Edit next to your campaign, and copy the name exactly as shown. This is the campaignName you’ll pass in every API request.
6

Use it in the API

Pass the campaignName in your API request entries. See the example below.
7

Publish the campaign

Finalize and publish the campaign from the Connectly UI. The API will reject sendouts for unpublished campaigns with a 409 error.
8

Trigger the sendout via API

Call POST /v1/businesses/{businessId}/send/campaigns with your recipient list. Connectly groups entries by campaign name and version and returns a per-sendout status report.
Your Account Manager can help you set up a campaign flow and share the campaignName to use in API requests.

​
Adding time delays

The Flow Builder includes a Time Delay card you can drop between any two message steps. After the initial message is sent, Connectly waits for the configured duration before delivering the follow-up. Maximum delay: 20 hours.
ConditionBehaviour
All customersFollow-up is sent to every customer who received the initial message.
Did not click a buttonFollow-up is sent only to customers who received the message but didn’t tap any button — useful for re-engagement nudges.
To add a delay, drag the Time delay card from the sidebar onto your canvas, position it between the two message cards, and connect the nodes. Set the duration and condition in the card settings, then publish as normal.
Use the “did not click a button” condition to avoid messaging customers who already responded.

​
Minimal API example

The smallest valid request — one recipient, one campaign, no variables: 
{
  "entries": [
    {
      "client": "+16045552331",
      "campaignName": "your_campaign_name"
    }
  ]
}
For the full request reference — variables, versioning, bulk sends, scheduling, and error handling — see Send Campaigns.

​
Next steps

Send Campaigns API

Full endpoint reference — entries, variables, versioning, options, and error responses.

Webhooks

Track delivery status and button clicks for each message in your campaign flow.