# `bird audiences`

## Usage

```bash
bird audiences
```

## Description

Manage audiences: named groups of contacts you can target. Membership
is managed explicitly: add or remove contacts by id.

Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

## Audiences

| Name                                             | Description                               |
| ------------------------------------------------ | ----------------------------------------- |
| [`create`](/docs/cli/reference/audiences-create) | Create an audience.                       |
| [`get`](/docs/cli/reference/audiences-get)       | Get an audience                           |
| [`list`](/docs/cli/reference/audiences-list)     | List audiences                            |
| [`update`](/docs/cli/reference/audiences-update) | Update an audience's name or description. |
| [`delete`](/docs/cli/reference/audiences-delete) | Delete an audience                        |

## Members

| Name                                                               | Description                             |
| ------------------------------------------------------------------ | --------------------------------------- |
| [`add-contacts`](/docs/cli/reference/audiences-add-contacts)       | Add contacts to a static audience.      |
| [`list-contacts`](/docs/cli/reference/audiences-list-contacts)     | List an audience's contacts             |
| [`remove-contact`](/docs/cli/reference/audiences-remove-contact)   | Remove a contact from an audience       |
| [`remove-contacts`](/docs/cli/reference/audiences-remove-contacts) | Remove contacts from a static audience. |