> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). Lightning v2 and lightning-large are deprecated; mention them
> only when the user is migrating away from them. Atoms is the
> voice-agent platform.

# Audiences

> Create and manage contact lists for outbound campaigns

Audiences are your contact lists — the people your agents will call during campaigns. Each audience contains phone numbers and any additional information you want your agent to reference during conversations.

***

## Your Audiences

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/3895256989c366de1e629e6550e99ea38c72b6928d4deaf8b94dc16721b83817/products/atoms/pages/platform/building-agents/images/audiences.png" alt="Audiences list" />

The Audiences page shows all your contact lists at a glance.

| Column        | Description                   |
| ------------- | ----------------------------- |
| Name          | Audience name and ID          |
| Campaigns     | Campaigns using this audience |
| Members       | Number of contacts            |
| Created on    | When the audience was created |
| Last modified | Last update time              |
| Actions       | Three-dot menu for options    |

**Sorting Options:**

* Created on
* Total members
* Last modified

**Filter Options:**

* All Audiences
* With Campaigns
* Without Campaigns

***

## Creating an Audience

Click **Create Audience** (green button, top right) to start a three-step process.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/51e5d5b55a3b9bc1e001ec35014a72e5d6f9b48ec859b3a072c5a6fc1df32a97/products/atoms/pages/platform/building-agents/images/upload-csv.png" alt="Upload CSV step" />

All recipients must have explicit consent to be contacted. Atoms prohibits purchased, rented, or third-party phone lists.

Upload a CSV with your contacts (max 10 MB). Your CSV needs a phone number column—everything else is flexible.

```csv
phoneNumber,Name,Email,CustomerID
919999900000,John,john@example.com,CUST001
919999900001,Alice,alice@example.com,CUST002
```

Phone numbers should be in international format (`+919999900000` or `919999900000`).

Tell us which column contains the phone numbers.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/bae4e219a7340cbc68feaaa7a7da7acfe4bc1c7d96b41f90daf94a986bf422f2/products/atoms/pages/platform/building-agents/images/map-phone.png" alt="Map phone number column" />

You'll see a preview of your CSV data. Select the column that contains valid phone numbers from the dropdown.

Only the phone number column needs to be mapped—everything else is up to you. Include any additional information you want available during calls (names, order IDs, account numbers, etc.).

Give your audience a name and optional description.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/32f40bb921404458fcaa86059ce175204e4dd34a7a7f98defe2026b38b2c3108/products/atoms/pages/platform/building-agents/images/add-contacts.png" alt="Name your audience" />

| Field         | Required | Example                                     |
| ------------- | -------- | ------------------------------------------- |
| Audience Name | Yes      | VIP Customers List                          |
| Description   | No       | High-value customers for premium promotions |

Click **Create Audience** to finish.

***

## Managing Audience Members

Click any audience to view and manage its contacts.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/86e64cbd08eadc35867a807d85e99c025cd23fa5cf6130c18e9af2f107916504/products/atoms/pages/platform/building-agents/images/audience-members.png" alt="Audience members view" />

Here you can:

* **Search** for specific members
* **Select contacts** using checkboxes
* **Delete** selected contacts with the Delete button
* **Add new** contacts with the Add New button

***

## Adding Members to Existing Audiences

Click **Add New** to add contacts to an existing audience. You have two options:

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/751bf00459e38566430a72483a32a6a2ef98d51f165bbc7cfd7412228c4c027d/products/atoms/pages/platform/building-agents/images/add-manually.png" alt="Add member manually" />

Fill in the contact details one at a time:

* **phoneNumber** (required) — in international format
* Plus any other fields defined in your audience

Click **Add Member** to save.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/65fbf0db2e8d43d11eb3e3b023316cf5009a7f6e0f3e398ad6dc9bfb3a226d09/products/atoms/pages/platform/building-agents/images/import-csv.png" alt="Import CSV to audience" />

Upload another CSV file to add contacts in bulk.

* CSV headers should match your audience fields
* Maximum file size: 10 MB
* Click to upload or drag and drop

***

## Using Audience Data in Calls

The columns you upload become available as variables during campaigns. If your CSV has a "Name" column, your agent can greet callers by name.

See [Variables](/atoms/atoms-platform/single-prompt-agents/configuration-panel/variables) for more.

***

## Related

Create outbound calling programs

Manage your phone numbers