---
title: "Create Audience"
method: POST
path: "/v1/audiences"
tags: ["Contact Management"]
---

# Create Audience

`POST /v1/audiences`

## Request body

- AudiencePostRequestDto
  - `data` object, required
    - `name` string — Name (unique identifier) of the audience. Maximum 45 characters
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP', required — Channel of the audience. Enumeration values [SMS, VIBER, WHATSAPP]
    - `contacts` ContactRequestDto[] — Contacts to add manually. Maximum 1000 contacts
      - `number` string, required — Phone number of the contact as digits without spaces or special characters, beginning with the country dialing code
      - `first_name` string — First name of the contact. Maximum 32 characters
      - `last_name` string — Last name of the contact. Maximum 32 characters
      - `custom1` string — Custom short attribute of the contact. Maximum 32 characters
      - `custom2` string — Custom long attribute of the contact. Maximum 70 characters

## Response `201`

Created

- AudiencePostResponseDto
  - `data` object
    - `id` string, uuid — Unique identifier of the audience
    - `account_id` string, uuid — Unique identifier of the account
    - `name` string — Name (unique identifier) of the audience
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP' — Channel of the audience. Enumeration values [SMS, VIBER, WHATSAPP]
    - `create_date` string, date-time — Creation date of the audience in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the audience in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `status` 'PENDING' | 'READY' — Status of the audience. Enumeration values [PENDING, READY]
    - `contacts_count` integer — Initial contacts count
    - `saved_contacts` integer — Saved contacts count
    - `invalid_contacts` integer — Invalid contacts count
    - `duplicate_contacts` integer — Duplicate contacts count
    - `links` object
      - `self` string — URL of the requested resource
      - `account` string — URL of the account
      - `contacts` string — URL of the contact

## Other responses

- `400` — **Bad Request:** Code Message Description 1304 'data.name' is invalid Only letters, numbers, and (- \_) are allowed 1305 'data.name' is too long Audience Name must be at most 45 characters 1306 'data.channel' is missing Channel is a required field 1307 'data.channel' should be onef of \[SMS, WHATSAPP, VIBER\] 1308 'data.contacts' must be at most 1000 items in length 1353 'data.number' is required If contacts array is provided, number is required 1354 'data.number' is invalid Should pass valid phone number. Number must be at most 45 characters 1361 'data.first\_name' is too long First name must be at most 32 characters 1362 'data.last\_name' is too long Last name must be at most 32 characters 1363 'data.custom1' name is too long Custom 1 must be at most 32 characters 1364 'data.custom2' name is too long Custom 2 must be at most 70 characters
- `409` — **Conflict:** Code Message 1309 Audience already exists

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)