---
title: "Update Single Audience"
method: PUT
path: "/v1/audiences/{id}"
tags: ["Contact Management"]
---

# Update Single Audience

`PUT /v1/audiences/{id}`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/audiences/{id}`
- Auth: API key in header `X-Dexatel-Key`

## Request body

- AudiencePutRequestDto
  - `data` object, required
    - `name` string, required: Name (unique identifier) of the audience. Maximum 45 characters

## Response `200`

OK

- AudienceResponseWrapperDto
  - `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: Saved contacts count
    - `total_contacts` integer: Initial contacts count
    - `valid_contacts` integer: Valid 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 1302 Invalid audience identifier Should be valid UUID
- `404`: **Bad Request:** Code Message Description 1303 'data.audience' name is required Audience name is required 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
- `409`: **Conflict:** Code Message 1309 Audience already exists

---

[API](https://skmtc.dev/dexatel/apis/contacts-and-messaging.md) - [All operations](https://skmtc.dev/dexatel/apis/contacts-and-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/contacts-and-messaging/revisions/f07e4f03a129?raw)