> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audiences

> The 6 adside commands for Audiences.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside audiences --help` to see what your installed version has.

## audiences imports

### audiences imports confirm

Approve the exact mapping and send the customer list to the channel.

Beta: this command may still change.

```bash theme={null}
adside audiences imports confirm --job-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--job-id` (required) | `<id>` | |
| `--selection` | `'<json>'` | Column selection. Omit for a prepared CSV to approve its stored identity mapping. |
| `--full-name-order` | `given-first\|family-first=given-first` | |
| `--audience-name` | `<audience-name>` | |
| `--default-country-calling-code` | `<default-country-calling-code>` | |

### audiences imports create

Prepare an audience import for explicit confirmation.

Beta: this command may still change.

```bash theme={null}
adside audiences imports create --asset-id <id> --channel META|LINKEDIN|GOOGLE_ADS --audience-name <audience-name> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--asset-id` (required) | `<id>` | |
| `--channel` (required) | `META\|LINKEDIN\|GOOGLE_ADS` | |
| `--audience-name` (required) | `<audience-name>` | |
| `--audience-description` | `<audience-description>` | |
| `--column-mapping` | `'<json>'` | |
| `--full-name-order` | `given-first\|family-first` | |
| `--prepared-csv` | `true\|false` | Validate a sandbox-prepared UTF-8 CSV with exact channel identifier headers, split names and international phones. Infer the mapping from those headers. |

### audiences imports get

Read audience mapping and import progress.

Beta: this command may still change.

```bash theme={null}
adside audiences imports get --job-id <id>
```

### audiences imports list

List audience import outcomes.

Beta: this command may still change.

```bash theme={null}
adside audiences imports list [flags]
```

| Flag | Value |
| - | - |
| `--take` | `<1-100>=20` |

### audiences imports preview

Inspect a CSV or spreadsheet before mapping audience identifiers.

Beta: this command may still change.

```bash theme={null}
adside audiences imports preview --asset-id <id>
```

### audiences imports retry

Resume a failed import with its immutable approved mapping.

Beta: this command may still change.

```bash theme={null}
adside audiences imports retry --job-id <id>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.