---
title: "Add a Caller ID and place its verification call"
method: POST
path: "/allowed_caller_ids"
tags: ["Allowed-Caller-IDs"]
---

# Add a Caller ID and place its verification call

`POST /allowed_caller_ids`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/allowed_caller_ids`
- Auth: API key in header `Authorization`

Adds a Caller ID to the account and places a verification call to it; the call reads out a verification code to submit with the verify method. `cli` is the phone number in E.164 format. Calling this again for a Caller ID that is not verified yet places a new verification call. The number of verification calls is limited per number and per account; once the limit is reached the request is rejected until later. Returns 422 with `errors` when the Caller ID can't be added or the call can't be placed.

## Request body

- AllowedCallerIdRequest: Body of `POST /portal/allowed_caller_ids`.
  - `cli` string, required: Phone number in E.164 format.

## Response `201`

Successful Response

- CallerIdResponse: Envelope returned when a Caller ID is added or verified.
  - `caller_id` CallerIdItem, required: A Caller ID of the account, verified or still waiting for verification.
    - `id` integer, required: Caller ID identifier, used to verify or delete it.
    - `cli` string, required: Caller ID number, E.164 (no leading "+").
    - `verified` boolean, required: Whether the Caller ID is verified.
    - `created_at` string, nullable: When the Caller ID was added (ISO 8601).

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)