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

# Create new contacts

`POST /contacts`

Create one or more contacts with the given phone numbers and optional names

## Request body

- CreateContact
  - `contacts` object[], required — Array of contact objects to be created. Type: array of object.
    - `contact_name` string — Name of the contact. Type: string.
    - `phone_number` string, required — Phone number as a string of digits. Typically 10 digits for US numbers.
    - `country_code` string — Country code for the phone number (must be +1). Type: string.
  - `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 contactIds for the newly added contacts.

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