Create a new Go-to-Marketing (GTM) Studio audience. An audience is a collection of contacts or companies that can be organized, filtered, and managed for marketing and sales purposes. You can use audiences to build and maintain business-critical datasets or enrich customer lists from trade shows and conferences.
You can define the audience name, audience type (CONTACT or COMPANY), and the source of the audience.
Currently, only CUSTOM audience sources are supported meaning the audience has no linked source dataset.
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 can be used to organize and group similar audiences or audiences that will be used for similar purposes.
Folders can be created using the Create New Folder endpoint, and the id can be provided
in the folderId field to create the audience within that folder. You can use the List Folders
endpoint to get a list of existing folders to place the audience into. If a folderId is not provided, the audience
creation process will create a new folder with the same name as the audience. This API will return an audience ID and asynchronously create the audience.
Use the Get Audience creation Status endpoint with the returned audience ID to track the progress and confirm when the audience has been created successfully.
Returns 202 Accepted with the audience id with which we can get the status of audience creation.
Returns 400 if required fields are missing or type is invalid.