---
title: "Create Contact in given audience"
method: POST
path: "/v1/audiences/{id}/contacts"
tags: ["Contact Management"]
---

# Create Contact in given audience

`POST /v1/audiences/{id}/contacts`

## Request body

- ContactPostRequestWrapperDto
  - `data` ContactRequestDto, required
    - `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`

OK

- ContactPostResponseDto
  - `data` object
    - `id` string, uuid — Unique identifier of the contact
    - `account_id` string, uuid — Unique identifier of the account
    - `audience_id` string, uuid — Unique identifier of the audience
    - `number` string — Phone number of the contact
    - `first_name` string — First name of the contact
    - `last_name` string — Last name of the contact
    - `custom1` string — Custom short attribute of the contact
    - `custom2` string — Custom long attribute of the contact
    - `create_date` string, date-time — Creation date of the contact in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the contact in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `links` object
      - `self` string — URL of the requested resource
      - `account` string — URL of the account
      - `audience` string — URL of the audience

## Other responses

- `404` — **Bad Request:** Code Message Description 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 1360 Contact 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)