---
title: "Add contacts to a contact list"
method: POST
path: "/contacts/lists/{id}/items"
tags: ["contacts"]
---

# Add contacts to a contact list

`POST /contacts/lists/{id}/items`

Adds contacts to a contact list. Available contact sources are: list of the contact entities, list of ids of existing contacts in user's account, list of phone numbers in E.164 format (11-digits)

## Path parameters

- `id` integer, required

## Request body

- AddContactListContactsRequest — Request object for adding new contacts to an existing contact list
  - `contacts` Contact[] — A list of new contact objects which need to be added
    - `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
  - `contactIds` integer[] — A list of ids of existing contacts in CallFire system
  - `contactNumbers` string[] — A phone number in E.164 format (11-digit). Examples: 12132000384
  - `contactNumbersField` string — A type of phone number (homePhone, workPhone, mobilePhone). This parameter works together with contactNumbers and specifies which types of numbers are included to a list
  - `useCustomFields` boolean — A flag to indicate how to define property names for contacts. If true, uses the field and property names exactly as defined. If false will assign custom properties and fields to A, B, C, etc

## 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)