---
title: "Create Contact"
method: POST
path: "/v4/accounts/{voip_id}/contacts"
tags: ["Account Contacts"]
---

# Create Contact

`POST /v4/accounts/{voip_id}/contacts`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/contacts`
- Auth: HTTP bearer

Add new account contact

## Path parameters

- `voip_id` integer, required

## Request body

- Contact
  - `name` string, nullable: Name
  - `company` string, nullable: Name of the contact's company
  - `phone` string, nullable: Contact phone number
  - `fax` string, nullable: Contact fax number
  - `primary_email` string, nullable: Primary email
  - `alternate_email` string, nullable: Alternate email
  - `address` object, nullable: Contact Address
    - `line_1` string, nullable: Address line 1
    - `line_2` string, nullable: Address line 2
    - `city` string, nullable: City
    - `province` string, nullable: Contact province
    - `postal_code` string, nullable: Contact postal code
    - `country` string, nullable: Country name

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)