> 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

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/3895256989c366de1e629e6550e99ea38c72b6928d4deaf8b94dc16721b83817/products/atoms/pages/platform/building-agents/images/audiences.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=75cf788e493ffac68974416234ed9b719be35f3a6a5cb948d4640355729d8437&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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.

#### Upload CSV

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/51e5d5b55a3b9bc1e001ec35014a72e5d6f9b48ec859b3a072c5a6fc1df32a97/products/atoms/pages/platform/building-agents/images/upload-csv.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=287a6aa3979c965b88031098cee31d741b9ee2aa147964c67765fe20b8f6bd6e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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`).

#### Map Phone Number

Tell us which column contains the phone numbers.

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/bae4e219a7340cbc68feaaa7a7da7acfe4bc1c7d96b41f90daf94a986bf422f2/products/atoms/pages/platform/building-agents/images/map-phone.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=e09af08df3e430e93b2cb2e2a5269c1ce31987c39ed68b54b610f0409ab41392&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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.).

#### Add Contacts

Give your audience a name and optional description.

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/32f40bb921404458fcaa86059ce175204e4dd34a7a7f98defe2026b38b2c3108/products/atoms/pages/platform/building-agents/images/add-contacts.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=f857807795a8ceb6265a0aadc84a78647eb2a7795e7c773f641bb3014d5f3a6d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/86e64cbd08eadc35867a807d85e99c025cd23fa5cf6130c18e9af2f107916504/products/atoms/pages/platform/building-agents/images/audience-members.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=9fbf090e7549f31db4e8475275bc5a114576ee79069139626fedc00accab1098&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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:

#### Add Manually

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/751bf00459e38566430a72483a32a6a2ef98d51f165bbc7cfd7412228c4c027d/products/atoms/pages/platform/building-agents/images/add-manually.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=d3d6f7cba5eb343b7eb586b454e80b2e4b0975ffe9dca11b8d475377e4b578b4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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.

#### Import CSV

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/65fbf0db2e8d43d11eb3e3b023316cf5009a7f6e0f3e398ad6dc9bfb3a226d09/products/atoms/pages/platform/building-agents/images/import-csv.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260811%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260811T111331Z&X-Amz-Expires=604800&X-Amz-Signature=72922fdeea013cb45237c9e57e7ffa23846c34f63d2db8464443ffb014fc08ba&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" 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 [Agent Config](/voice-agents/platform/create-agent/agent-config) for more on Variables.

---

## Related

#### [Campaigns](/voice-agents/platform/deploy/campaigns)

Create outbound calling programs

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

Manage your phone numbers

{/* coding-agent-callout-injected */}