---
title: "Bulk calling"
method: POST
path: "/api/v1/call/{widget_id}/contacts"
tags: ["Calling"]
---

# Bulk calling

`POST /api/v1/call/{widget_id}/contacts`

To initiate calls to a list of contacts in bulk

## Path parameters

- `widget_id` string, uuid, required — Widget ID to be used for initiating the call. It must be connected to Twilio, Plivo or Telnyx.

## Request body

- CampaignMetadata
  - `contact_ids` string[], required — List of UUIDs that identify the contacts to receive the campaign.
  - `message` string, nullable — (Only for Chat based assistants, ignored for calling) Message to be sent
  - `start_new_conversation` boolean, nullable — (Always True for calling campaigns) Start a brand‑new thread instead of replying in the existing one.

## Response `200`

Campaign has been qeueud

- IPostResponseBase
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` unknown

## Other responses

- `401` — Authentication credentials are missing or invalid
- `404` — Widget not found or not one of the supported widgets for call campaign
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal server error

---

[API](https://skmtc.net/insighto/apis/ragify.md) · [All operations](https://skmtc.net/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insighto/ragify/revisions/cdca56191be9/schema)