---
title: "Create CRM contact"
method: POST
path: "/v2/crm/contacts"
---

# Create CRM contact

`POST /v2/crm/contacts`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/crm/contacts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/crm/contacts/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to create a CRM contact.

## Request body

- object
  - `email` string, required: The new contact email address.
  - `phone` object: Object that holds details of the phone number.
    - `number` string: Contact phone number. Must be 10 or 16 characters.
    - `country_code` string: Contact country code. Must be 2 characters.
  - `address` object: Object that holds details about the contact address.
    - `city` string: The city where the contact is located. Maximum 128 characters.
    - `state` string: The state where the contact is located (only for United States). Maximum 128 characters.
    - `street` string: The street where the contact is located. Maximum 255 characters.
    - `country` string: The country where the contact is located. Required when `zip_code` parameters is specified.
    - `zip_code` string: Zip code of the area where the contact is located. Maximum 10 characters.
    - `apartment` string: The appartment office where the contact is located. Maximum 255 characters.
  - `company` object: Object that holds details about the company that this contact represents.
    - `name` string: The name of the company. Maximum 128 characters.
    - `job_title` string: Job title of the contact in this company. Maximum 128 characters.
  - `last_name` string: The new contact last name. Maximum 128 characters.
  - `first_name` string: The new contact first name. Maximum 128 characters.
  - `description` string: Contact description. Maximum 408 characters.

## Response `201`

The contact was created.

- object
  - `data` object: The created contact.
    - `id` string: ID of the created contact.

## Other responses

- `400`: * Request with any of cases: invalid token, expired token, empty header, authorization = null, authorization without value. * Request with incorrect body parameters, see examples.
- `422`: * User already has a contact with this email. * Zip code does not match the country. * Invalid country name provided. * Invalid state name provided. Only for United States. * Invalid phone country code provided.

---

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