--- title: "Audiences" slug: "audiences" updated: 2026-11-02T15:25:00Z published: 2026-11-02T15:25:00Z canonical: "docs.antavo.com/audiences" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.antavo.com/llms.txt > Use this file to discover all available pages before exploring further. # Audiences Audiences are customer groups that can be used for targeting across Antavo. In the Management UI, you can create and edit audiences, review their activity, and delete audiences that are no longer in use. Audiences can also be created and managed through the [Audiences API](https://developers.antavo.com/reference/post_v1-audience). Audiences are **static**, meaning that membership is explicitly managed through the [Audiences API](https://developers.antavo.com/reference/post_v1-audience-membership-add-audience-id) or [audience-related workflow actions](/engine/docs/actions#add-to-audience) rather than automatically recalculated based on customer data or behavior. To learn how audiences differ from segments and customer lists, see [Customer groups](/engine/docs/customer-grouping). > [!NOTE] > The Audiences module must be enabled to access audience functionality in the Management UI and use audiences in supported Antavo features. ## Audiences in the Management UI Navigate to the **Audiences** page by clicking the Audiences icon in the sidebar. The page lists the audiences in the current workspace, including those created through both the UI and the API. The following information is displayed for each audience: - **Name**: The name and description of the audience. - **External ID**: The audience's identifier in an external system, if provided. - **Type**: The type of the audience. Currently, only external audiences are supported. - **Source**: The source associated with the audience, if provided. - **Members**: The number of customers currently included in the audience. - **Created At**: The date and time when the audience was created. - **Last Updated**: The date and time when the audience was last updated. Use the search field to find an audience by name or External ID. To open an audience, click the three-dot menu at the end of its row and select **Open**. Click **Edit** to open the editing page directly. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience list.png) ## Creating an audience - Click **Create Audience** in the top-right corner of the list page If there are no audiences yet, you can also click **Create Your First Audience** in the empty list. - Under **Type**, the **External** type is automatically selected Currently, only the **External** audience type is available. - Enter the audience **Name** - Optionally, enter an **External ID** to match the audience's identifier in an external system. This is separate from the audience's internal Antavo ID. - Enter a **Description** to explain the audience's purpose - Click **Create audience** An External ID must be unique within the workspace. It can contain lowercase letters, numbers, and hyphens, with a maximum length of 64 characters. It cannot be changed after the audience is created. An audience can be created without members. To add customers, use the [Audiences API](https://developers.antavo.com/reference/post_v1-audience-membership-add-audience-id) or a [workflow action](/engine/docs/actions#add-to-audience). ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience create.png) > [!NOTE] > You cannot add or remove customers directly in the Management UI. To manage audience membership, use the [Audiences API](https://developers.antavo.com/reference/post_v1-audience-membership-add-audience-id) or the [**Add to audience**](/engine/docs/actions#add-to-audience) and [**Remove from audience**](/engine/docs/actions#remove-from-audience) workflow actions. ## Viewing audience details Open an audience from the list to review its properties and recent activity. The page displays the **External ID**, **Type**, **Source**, **Members**, **Dependencies**, **Created At**, and **Last Updated** values. Membership changes submitted through the API are processed asynchronously, so the member count may take some time to update. ### Dependencies **Dependencies** show how many active configurations in Antavo use the audience. Inactive, expired, or disabled configurations are excluded from this count. If the counter is greater than **0**, click it to open the **Dependencies** window. It lists the configurations that reference the audience, grouped by module, so you can identify where the audience is used. An audience can only be **deleted** when its **Dependencies** value is **0**. Before deleting an audience that is still in use, remove its references from the listed configurations. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience dependencies.png) ### Activity log The **Activity Log** section displays the latest 15 audience-related actions, with the most recent first. These include audience creation, audience updates, and members being added or removed. Each entry shows the action, its date and time, and a short summary. Activity log entries are retained for 90 days. > [!NOTE] > The audience activity log is separate from a customer's event history in Customer Insights. A membership change recorded here does not necessarily register an event on the customer's profile. See **Audience membership events**. See [Audience membership events](/docs/audiences#audience-membership-events). ## Editing an audience - Open the audience and click **Edit**, or select **Edit** from its three-dot menu in the audience list - Update the **Name** or **Description** - Click **Save changes** The External ID, type, source, member count, dependencies, and creation and update timestamps are read-only. ## Deleting an audience You can delete an audience only when its **Dependencies** value is **0**. - Open the audience from the audience list - Check that **Dependencies** is **0** If it is greater than **0**, click the count to review the dependencies and remove the audience from those configurations. - Click **Delete** in the top-right corner - Click **Delete audience** to confirm After deletion, the audience is removed from the list, and its memberships are removed in the background. > [!NOTE] > Deletion is permanent and irreversible. ## Audience membership in Customer Insights Open the customer profile in [Customer Insights](/docs/customer-insights) and navigate to the **Audiences** section to view the customer's current audience memberships. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audiences_cust_ins (2).png) ## Use audiences in Workflows When the **Audiences** module is enabled, the [Add to audience](/engine/docs/actions#add-to-audience) and [Remove from audience](/engine/docs/actions#remove-from-audience) action nodes are available in Workflows. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience_workflow.png) Audience membership can be used in **Customer attribute** filters. Use the *in audience* or *not in audience* relation to filter customers based on whether they belong to a selected audience. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience_filter.png) ## Audience membership events The **Add to audience** and **Remove from audience** workflow actions register the corresponding `add_to_audience` and `remove_from_audience` events in the customer's event history. These events can also be used as [event triggers](/engine/docs/triggers#:t3:-Event) in workflows. ![](https://cdn.document360.io/08a474ca-8fb4-4c3c-9cd8-665242086cd3/Images/Documentation/audience_event.png) > [!WARNING] > Using the [Add customers to audience API endpoint](https://developers.antavo.com/reference/post_v1-audience-membership-add-audience-id) does not register an `add_to_audience` event in the customer's event history. Similarly, using the [Remove customers from audience API endpoint](https://developers.antavo.com/reference/post_v1-audience-membership-remove-audience-id) does not register a `remove_from_audience` event. ## Use audiences across Antavo Audiences can be used for customer targeting in the [Promotion Engine](/engine/docs/configuring-promotions). In the Loyalty Engine, audiences can be used in customer filters and Workflows. Audience support in [Rewards](/engine/docs/rewards) and [Challenges](/engine/docs/challenges) is currently available in beta.