> For the complete documentation index, see [llms.txt](https://docs.bluepro.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluepro.ai/customers-and-sales/contacts-and-leads/building-and-using-audiences.md).
# Building & Using Audiences
An **audience** is a saved group of contacts you can target all at once — most often to enroll them in an outreach campaign. Instead of hand-picking people every time, you define who belongs (by labels, tags, or activity) and BluePro keeps the group up to date for you. This guide covers building audiences and putting them to work.
**Who this is for:** Owners and office staff who do customer outreach and marketing.
### What Is an Audience?
Think of an audience as a smart list of customers — for example, *"VIP customers with no active job in the last 6 months."* You can:
* Build it from **filters** so it stays current automatically, or
* Add specific contacts to it **by hand**, or both.
Audiences live on the **Contacts** page and are most useful as the starting point for an **outreach campaign**.
### Where to Find Audiences
On the **Contacts** page, click the **Audiences** button to open the audiences manager. From there you can search your audiences, **Create Audience**, and open any audience to edit it or see who's in it.
### Creating an Audience
Click **Create Audience** and fill in:\
\
**Name** (required) and an optional **Description** — e.g., *"VIP Customers."*
1. **Filter Criteria:**
* **Contact Labels** — include or exclude by label (each set to **Has** or **Doesn't have**)
* **Service Tags** — include or exclude by job tag (**Has** / **Doesn't have**)
2. **Quick Filters** (toggle on the ones you want):
* **Open Tasks** — has / doesn't have open tasks, within a time window
* **Active Jobs** — has / doesn't have active jobs, within a time window
* **Last Activity** — **Active within** or **Inactive for** a set number of **Days / Weeks / Months / Years**
3. Choose **Keep synced** (see below).
4. Click **Create Audience**.
> 💡 **Tip — Combine filters to get specific.** Filters stack, so you can build precise groups like *"has the VIP label AND no active job in the last 6 months"* — perfect for a win-back campaign.
### Keep Synced vs. Frozen
When creating an audience you'll see a **Keep synced** option:
* **Keep synced (on)** — the audience updates itself. As contacts start or stop matching your filters, they're added or removed automatically. *Recommended for most cases.*
* **Keep synced (off)** — the audience is **frozen at creation time** and won't auto-update — a snapshot of who matched right then.
> 💡 **Tip — Synced audiences are "set it and forget it."** Build *"customers inactive for 6+ months"* once with Keep synced on, attach it to a win-back campaign, and it keeps pulling in newly-inactive customers over time.
### Two Ways to Fill an Audience
* **By filters (dynamic):** the criteria above decide who's in. This is the cleanest way and pairs with **Keep synced**.
* **By hand:** from the **Contacts** list, select the contacts you want, then **Bulk Actions → Add to Audience**. Manually added contacts stay in the audience even if they don't match the filters.
> ⚠️ **Note — Watch "Select all in the system."** If you tick *"Select all contacts in the system"* and then **Add to Audience**, it adds **every** contact in your branch — it does **not** respect the filters you have applied on the list. To target a filtered group, either build the audience with **filters** instead, or select the specific contacts by hand.
> 💡 **Tip — There's a 25,000-contact cap.** An audience holds up to 25,000 contacts. If you build one with no filters and you have more than that, only the first 25,000 are included — so use filters to scope large audiences.
### Managing an Audience
Open an audience from the Audiences manager to:
* **Edit** its name, description, filters, or sync setting
* **View the contacts** currently in it, and **remove** contacts you don't want
* **Delete** the audience when you no longer need it
### Using an Audience in a Campaign
Audiences shine when you feed them into outreach. In **Outreach**, create or edit a campaign and add an **enrollment trigger of type "Audience,"** then pick your audience. Everyone in it is enrolled — and if the audience is **synced**, new matching contacts are enrolled automatically as they qualify.
> 💡 **Tip — Audience + synced + campaign = automatic outreach.** A synced audience attached to an active campaign keeps enrolling the right people with no manual work.
### FAQ
* **What's the difference between a label and an audience?** A **label** tags one contact; an **audience** is a whole group you can target — and it can be built *from* labels.
* **Will a synced audience add new customers automatically?** Yes — anyone who starts matching the filters is added (and those who stop matching drop out).
* **Can I mix filters and hand-picked contacts?** Yes. Filters pull people in automatically; manually added contacts stay regardless.
* **Why did my audience grab everyone?** Likely "Select all in the system" was used with Add to Audience, which ignores list filters. Use filters or pick contacts individually.
* **How many contacts can an audience hold?** Up to 25,000.
* **How do I actually message an audience?** Attach it to an outreach campaign (SMS/email/task sequence) via an Audience enrollment trigger.
*
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.bluepro.ai/customers-and-sales/contacts-and-leads/building-and-using-audiences.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.