Send Messages To Contacts

To send messages to a list of contacts in bulk

• widget_id: Widget ID to be used for sending the message. It must be connected to WhatsApp or SMS.
• contact_ids: list of contact IDs to whom the message is to be sent.
• message: text message to be sent.
• start_new_conversation: whether to start a new conversation or pick the latest.

Authorizations

api_key · string · query · required

Your API key for authentication. You can generate it from the Settings page. Format: starts with in-.

Path Parameters

widget_id · string · required

Body

application/json

contact_ids · string[] · required

List of UUIDs that identify the contacts to receive the campaign.

Minimum length: 1

Example:

[
  "a3ae8c0f-2e9d-4c18-8c0e-d510e3cacb04",
  "8a849d72-93cf-4e6c-b1a3-6c10d4c65f1d"
]

message · string | null

(Only for Chat based assistants, ignored for calling) Message to be sent

Example:

"Hi Adam, check out our new offer!"

start_new_conversation · boolean | null · default: false

(Always True for calling campaigns) Start a brand‑new thread instead of replying in the existing one.

Example:

true

Response

200

application/json

Successful Response

The response is of type any.