---
title: "Create one or many contacts"
method: POST
path: "/contacts"
tags: ["Contacts"]
---

# Create one or many contacts

`POST /contacts`

Creates a single contact or a batch of contacts. Accepts a JSON array or an object with a "contacts" array.

## Request body

- RequestsContactStoreRequest
  - `contacts` RequestsContactItem[], required
    - `emails` string[]
    - `name` string, required
    - `phone_numbers` string[], required
    - `properties` object

## Response `201`

Created

- ResponsesContactsCreatedResponse
  - `data` EntitiesContact[], required
    - `created_at` string, required
    - `emails` string[], required
    - `id` string, required
    - `name` string, required
    - `phone_numbers` string[], required
    - `properties` object, required
    - `updated_at` string, required
    - `user_id` string, required
  - `message` string, required
  - `status` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ndolestudio/apis/httpsms-api-reference.md) · [All operations](https://skmtc.dev/ndolestudio/apis/httpsms-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ndolestudio/httpsms-api-reference/revisions/7e5d7ce790b3/schema)