---
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`

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

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)