Create New Audience

Create a named working list of people (CONTACT) or companies (COMPANY) to drive a GTM motion — campaign targeting, enrichment runs, outbound sequences, or importing leads from trade shows and events.

You can define the audience name, audience type (CONTACT or COMPANY), and the source of the audience.
Supported audience sources are:

  • CUSTOM: audience has no linked source dataset.
  • ZOOMINFO_PUBLIC_API: audience is defined by zoomInfoSearchCriteria.
    Requests to create audiences can optionally include definitions for columns to be added to the audience.
    If no column definitions are provided, the audience will be created without any columns, and columns may
    be added in the future using the Create New Columns endpoint.

Folders: Every audience must live in a folder. Pass folderId to place it in an existing folder (use List Folders to find one). If folderId is omitted, GTM Studio automatically creates a new folder with the same name as the audience.

Columns: Define columns up front — they describe the shape of data you intend to load. The columnId values returned here are required when loading rows via Bulk Upsert Rows. Choose dataType carefully — it cannot be changed after creation. If columns is omitted, the audience is created with no columns; add them later via Create New Columns before loading any rows.

For zoomInfoSearchCriteria, use the Lookup Data endpoint to retrieve valid values.

Returns 201 Created with the audience resource.
Returns 400 if required fields are missing or type is invalid.

Query Params
boolean
Defaults to false

When true, the system uses AI to automatically infer and apply match criteria mappings for columns (for example, mapping an "Email" column to CONTACT_EMAIL). Defaults to false. Set to true to enable auto-mapping; leave false to define match criteria manually.

Body Params

Request body containing the audience creation details

JSON API model for Audience.

data
object
required

The primary data of the document

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json