---
title: "Add a custom data column to campaign contacts"
method: POST
path: "/campaigns/call/{campaignscalllistuuid}/numbers/columns"
tags: ["campaigns"]
---

# Add a custom data column to campaign contacts

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

## Request

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

Adds a new custom column to all contacts in a campaign's call queue. The column is added to the `social_data` field of every contact's `json_csv_infos`. The column name must be unique — it cannot duplicate an existing field name in or outside of `social_data` (e.g., `firstname`, `lastname`, `company` are reserved). An initial value can be provided for each contact. This operation is logged in the campaign's audit log (see `GET .../logs`).

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

## Path parameters

- `campaignscalllistuuid` string, uuid, required

## Request body

- CampaignCalllistNumbersAddColumns: Add column to the campaign calllist numbers. If no value is specified for a number, it will be added with an empty value
  - `name` string, required: Name of the column to add
  - `numbers_data` object: Map of values for each number. If no value is specified for a number, it will be added with an empty value

## Response `200`

Successful operation

## Other responses

- `400`: Invalid request (empty name, invalid numbers). Column name already exists.
- `401`: Token unauthorized
- `404`: Campaign 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/columns/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)