---
title: "Create contact list"
method: POST
path: "/contact-lists"
tags: ["SMS Broadcast"]
---

# Create contact list

`POST /contact-lists`

Create a new contact list with the given parameters

## Request body

- CreateContactList
  - `list_name` string, required — Name of the contact list. Type: string.
  - `description` string — Description of the contact list. Type: string.
  - `numbers` object[], required — List of contact numbers. Type: array of object.
    - `name` string — Name of the contact. Type: string.
    - `country_code` string — Country code of the contact (must be +1). Type: string.
    - `phone_number` string, required — Phone number as a string of digits. Typically 10 digits for US numbers.
  - `group_id` integer, required — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.

## Response `200`

The result of the creation and contactListId for the newly added contact list.

- PostResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` string — Response payload. Shape varies by endpoint.

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