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.

When autoMatchCriteria is true, the system uses AI to automatically infer match criteria mappings for columns — for example, mapping an "Email" column to CONTACT_EMAIL.

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