> 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. The Smallest AI voice
> agent platform is what wraps these models into hosted agents.

# 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

![Audiences list](/_fern-img/3895256989c366de1e629e6550e99ea38c72b6928d4deaf8b94dc16721b83817.webp)

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.

#### Upload CSV

![Upload CSV step](/_fern-img/51e5d5b55a3b9bc1e001ec35014a72e5d6f9b48ec859b3a072c5a6fc1df32a97.webp)

> **Warning**
>
> 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`).

#### Map Phone Number

Tell us which column contains the phone numbers.

![Map phone number column](/_fern-img/bae4e219a7340cbc68feaaa7a7da7acfe4bc1c7d96b41f90daf94a986bf422f2.webp)

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

> **Tip**
>
> 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.).

#### Add Contacts

Give your audience a name and optional description.

![Name your audience](/_fern-img/32f40bb921404458fcaa86059ce175204e4dd34a7a7f98defe2026b38b2c3108.webp)

| 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.

![Audience members view](/_fern-img/86e64cbd08eadc35867a807d85e99c025cd23fa5cf6130c18e9af2f107916504.webp)

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:

#### Add Manually

![Add member manually](/_fern-img/751bf00459e38566430a72483a32a6a2ef98d51f165bbc7cfd7412228c4c027d.webp)

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.

#### Import CSV

![Import CSV to audience](/_fern-img/65fbf0db2e8d43d11eb3e3b023316cf5009a7f6e0f3e398ad6dc9bfb3a226d09.webp)

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 [Agent Config](/voice-agents/build/agent-settings) for more on Variables.

---

## Related

#### [Campaigns](/voice-agents/telephony/campaigns)

Create outbound calling programs

#### [Phone Numbers](/voice-agents/telephony/phone-numbers)

Manage your phone numbers