---
title: "Create a candidate phone"
method: POST
path: "/candidates/{candidate_id}/phones"
tags: ["Candidates"]
---

# Create a candidate phone

`POST /candidates/{candidate_id}/phones`

## Request

- Base URL: `https://api.catsone.com`
- URL: `https://api.catsone.com/candidates/{candidate_id}/phones`
- Auth: none declared
- TypeScript: <https://skmtc.dev/catsone/apis/cats-api-v3/docs/candidates/:candidate_id/phones/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `candidate_id` number, required

## Request body

- object
  - `number` string, required: This number MUST begin with the country code. It will not be parsed correctly otherwise.
  - `extension` string
  - `type` string, required: One of `mobile`, `home`, `work`, `fax`, `main`, or `other`.

## Response `201`

Created

---

[API](https://skmtc.dev/catsone/apis/cats-api-v3.md) - [All operations](https://skmtc.dev/catsone/apis/cats-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/catsone/apis/cats-api-v3/revisions/dedbbade450d?raw)