---
title: "Create a contact"
method: POST
path: "/accounts/self/contacts"
tags: ["Contacts"]
---

# Create a contact

`POST /accounts/self/contacts`

Create a new contact (Permitted scopes: **fax:all:edit**)

## Request body

- ContactCreate
  - `name` string, required — Contact name
  - `fax_number` string, required — Contact's fax number
  - `email` string — Contact's email address
  - `cellphone` string — Contact's cellphone number
  - `phone` string — Contact's phone number
  - `notes` string — Additional notes
  - `groups` string[] — List of group names
  - `is_telefax` boolean — Whether this contact has a human fax operator. When enabled, an IVR will ask the operator to switch to fax mode
  - `shared` boolean — Whether to share contact with corporate members

## Response `201`

Contact created successfully

## Other responses

- `400` — Error object in case there's a problem with given data
- `401` — Error object in case there's a problem with the authorization
- `500` — Error object in case there's a server error

---

[API](https://skmtc.net/fax/apis/fax-plus-rest-api.md) · [All operations](https://skmtc.net/fax/apis/fax-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fax/fax-plus-rest-api/revisions/c1afc85d2c15/schema)