v2

latestOpenAPI 3.1.02026-07-26231357386.7 KB

Calling

Bulk calling

To initiate calls to a list of contacts in bulk

post/api/v1/call/{widget_id}/contacts

Path parameters

widget_idstring uuid required

Widget ID to be used for initiating the call. It must be connected to Twilio, Plivo or Telnyx.

Request body

contact_idsstring[] required

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

messagestring nullable

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

start_new_conversationboolean nullable

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

Example request

{
  "contact_ids": [
    "a3ae8c0f-2e9d-4c18-8c0e-d510e3cacb04",
    "8a849d72-93cf-4e6c-b1a3-6c10d4c65f1d"
  ],
  "message": "Hi Adam, check out our new offer!",
  "start_new_conversation": true
}

Response

Campaign has been qeueud

messagestring nullable

{"stackTrail":"components:schemas:IPostResponseBase:properties:data:anyOf","oasType":"schema","type":"unknown","title":"Data","nullable":true}