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.

POST /api/v1/messaging/{widget_id}/contacts

Send Messages To Contacts

cURL

curl --request POST \
  --url 'https://api.example.com/api/v1/messaging/{widget_id}/contacts?api_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contact_ids": [
    "a3ae8c0f-2e9d-4c18-8c0e-d510e3cacb04",
    "8a849d72-93cf-4e6c-b1a3-6c10d4c65f1d"
  ],
  "message": "Hi Adam, check out our new offer!",
  "start_new_conversation": true
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Your API KeyHTTPBearer

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<uuid> · required

Body

application/json

contact_ids · string<uuid>[] · required

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

Minimum array 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