---
title: "Add contacts to a campaign's call queue"
method: POST
path: "/campaigns/call/{campaignscalllistuuid}/numbers"
tags: ["campaigns"]
---

# Add contacts to a campaign's call queue

`POST /campaigns/call/{campaignscalllistuuid}/numbers`

## Request

- Base URL: `https://public-api.ringover.com/v2`
- URL: `https://public-api.ringover.com/v2/campaigns/call/{campaignscalllistuuid}/numbers`
- Auth: API key in header `Authorization`

Adds one or more phone numbers (contacts) to a campaign's call queue. Each number can include associated metadata via the `json_csv_infos` field (firstname, lastname, company, and custom fields in `social_data`). All numbers' `social_data` arrays must have the same set of custom field keys. If a number is already in the queue, it is reported in the response but not duplicated. Returns `304` if all numbers were already present.

**Permission:** No specific permission required. A valid API key is sufficient.

## Path parameters

- `campaignscalllistuuid` string, uuid, required

## Request body

- CampaignCalllistAddNumbers
  - `to_numbers` object[]
    - `to_number` integer
    - `priority_order` integer: The priority order of the number in the campaign calllist, the lower the number, the higher the priority
    - `json_csv_infos` string, json: Contains data related to the number. json_csv_infos must follow the schema: {"company": "", "firstname": "", "lastname": "", "social_data": [{"optionalField": ""}, ...]} The fields "company", "firstname", "lastname" and "social_data" are required. The field "social_data" is an array of objects, each containing a key-value pair of type string. All numbers' json_csv_infos must have the same fields in "social_data".

## Response `200`

Successful operation

- CampaignCalllistAddNumbersResponse
  - `numbers_added_in_queue` NumberResp[]: The list of added phone numbers
    - `to_number` integer
  - `numbers_already_in_queue` NumberResp[]: The list of phone numbers that were already in queue
    - `to_number` integer

## Other responses

- `304`: Not Modified
- `400`: Invalid ID supplied
- `401`: Token unauthorized
- `404`: Group not found
- `500`: Internal server error

## Changes

- **2025-11-20** `d92d55716cc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ringover/apis/ringover-public-api/changes/campaigns/call/:campaignscalllistuuid/numbers/post.md)

---

[API](https://skmtc.dev/ringover/apis/ringover-public-api.md) - [All operations](https://skmtc.dev/ringover/apis/ringover-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringover/apis/ringover-public-api/revisions/645bfcebdd56?raw)