---
title: "Create contacts"
method: POST
path: "/contacts"
tags: ["contacts"]
---

# Create contacts

`POST /contacts`

Creates contacts in CallFire system. Only values from the next list can be used as external system parameter in contact creation: **NATION_BUILDER, SALES_FORCE_CONTACTS, SALES_FORCE_LEADS, SALES_FORCE_REPORTS**. See [contacts validation rules](https://www.callfire.com/help/docs/getting-started/managing-contacts/validating-contacts#section1)

## Request body

- Contact[]
  - `id` integer — An id of a contact
  - `firstName` string — A first name of a contact
  - `lastName` string — A last name of a contact
  - `zipcode` string — A Zip code of a contact
  - `homePhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `workPhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `mobilePhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `extraPhone1` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `extraPhone2` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `extraPhone3` string — Phone number in E.164 format (11-digit). Example: 12132000384
  - `externalId` string — An external id of a contact for syncing with external sources
  - `externalSystem` string — External system that external id refers to
  - `properties` object — Map of user-defined string properties for contact
  - `deleted` boolean — A deleted contact, deleted contacts are hidden from search results

## Response `200`

successful operation

- ResourceIdList — ~
  - `items` object[] — ~
    - `id` integer — An id of a resource

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)