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

# Add contact numbers to a contact list

`POST /contact-lists/{id}/contacts`

Add multiple contact numbers to an existing contact list with validation for duplicates

## Path parameters

- `id` integer, required

## Request body

- AddContactNumbers
  - `numbers` object[], required — Array of contact objects to be added to the contact list. Type: array of object.
    - `contact_name` string, required — Name of the contact. Type: string.
    - `country_code` string — Country code for the phone number (must be +1). Type: string.
    - `phone_number` string, required — Phone number as a string of digits. Typically 10 digits for US numbers.
  - `status` 'active' | 'inactive' | 'deleted' — Status of the contacts (defaults to 'active'). Type: enum (string); Allowed values: active, inactive, deleted.

## Response `200`

Contact numbers added successfully

- AddContactNumbersResponse
  - `status` string — Status of the operation. Type: string.
  - `message` string — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).
  - `inserted` integer — Number of contacts inserted. Type: integer.
  - `duplicates` object[] — Array of duplicate contacts found (if any). Type: array of object.
    - `country_code` string — country_code. Type: string.
    - `phone_number` number — Phone number as a string of digits. Typically 10 digits for US numbers.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)