ZoomInfo Audiences API
The Audiences API from ZoomInfo — 20 operation(s) for audiences.
ZoomInfo Audiences API is one of 42 APIs that ZoomInfo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Audiences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 30 operations across 20 paths, and defines 139 schemas. It is described by OpenAPI 3.2.0, at version 1.0.
Requests are made against a single base URL, https://api.zoominfo.com/gtm.
30 operations
20 paths
139 schemas
5 DELETE11 GET3 PATCH10 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
ZoomInfo Audiences API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (OAuth2Auth) using the authorizationCode flow, exposing 2 scopes.
By default, every request must be authenticated.
Paths & Operations 30
Across 20 paths, the API surfaces 30 operations — 5 DELETE, 11 GET, 3 PATCH, 10 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Audiences 30
POST
/studio/v1/folders
Create New Folder
GET
/studio/v1/folders
List Folders
GET
/studio/v1/folders/{folderId}
Get Specific Folder
PATCH
/studio/v1/folders/{folderId}
Update Folder
DELETE
/studio/v1/folders/{folderId}
Delete Specific Folder
POST
/studio/v1/audiences
Create New Audience
GET
/studio/v1/audiences
List Audiences
GET
/studio/v1/audiences/{audienceId}
Fetch Audience
DELETE
/studio/v1/audiences/{audienceId}
Delete Audience
PATCH
/studio/v1/audiences/{audienceId}
Update Audience
GET
/studio/v1/audiences/{audienceId}/filter-metadata
Get Audience Filter Metadata
POST
/studio/v1/audiences/{audienceId}/actions/match-criteria
Upsert Column Match Criteria
POST
/studio/v1/audiences/{audienceId}/actions/enrich
Enrich Audience
GET
/studio/v1/audiences/{audienceId}/jobs/{jobId}
Get Job Status
POST
/studio/v1/audiences/{audienceId}/columns/actions/bulk/create
Create New Columns
GET
/studio/v1/audiences/{audienceId}/columns/data-dependencies/{tool}
Get Column Data Dependencies
PATCH
/studio/v1/audiences/{audienceId}/columns/{columnId}
Update Column
DELETE
/studio/v1/audiences/{audienceId}/columns/{columnId}
Delete Column
GET
/studio/v1/audiences/{audienceId}/rows/{rowId}
Get Row by ID
POST
/studio/v1/audiences/{audienceId}/rows/actions/search
List Rows
POST
/studio/v1/audiences/{audienceId}/rows/actions/upsert
Upsert Rows
POST
/studio/v1/audiences/{audienceId}/rows/actions/bulk/upsert
Bulk Upsert Rows
DELETE
/studio/v1/audiences/{audienceId}/rows/actions/bulk/delete
Delete Rows
POST
/marketing/v1/audiences
Creates a new audience
GET
/marketing/v1/audiences
Lists all audiences
GET
/marketing/v1/audiences/{audienceId}
Gets existing audience by ID
PUT
/marketing/v1/audiences/{audienceId}
Updates audience by ID
DELETE
/marketing/v1/audiences/{audienceId}
Deletes audience by ID
POST
/marketing/v1/audiences/{audienceId}/uploads
Creates new audience upload
GET
/marketing/v1/audiences/{audienceId}/uploads/{uploadId}
Gets audience upload status
Schemas 139
The contract defines 139 schemas that model the data the API accepts and returns. The most detailed are ZoomInfo.SearchCriteria.ContactSearch (88 properties), ZoomInfo.SearchCriteria.CompanySearch (62 properties), ReadColumnAttributes (15 properties), AiColumn (13 properties). Each schema is shown below with its type and property counts.
EnrichJob
object
Enrich async job response resource.
2 properties
2 required
BulkRowUpsertListApiModel
object
JSON API model for bulk upsert Row request. Row id is optional — omit to create, provide to update.
1 property
1 required
RowUpsertListApiModel
object
JSON API model for synchronous upsert Row request (≤ 50 rows). Row id is optional — omit to create, provide to update.
1 property
1 required
Page
object
Page details for paginated responses.
2 properties
2 required
StringArray
array
Represents a list of string values for a field
StaticColumn
object
Column model representing static column in an audience.
10 properties
8 required
UpsertMatchCriteriaRequest
object
Upsert match criteria request resource.
3 properties
3 required
ColumnType
string
MatchCriteria
object
Defines a single match criterion that maps an audience column to a ZoomInfo attribute for row matching during enrichment.
2 properties
2 required
EnrichAudience
object
Audience enrichment request resource.
2 properties
2 required
FoldersPagingLinks
object
Paging links for Folder list.
4 properties
EnrichmentScope
string
Specifies the scope of enrichment operation: AUDIENCE enriches all rows, ROW enriches specific rows by ID.
StringArrayItem
array
Represents a list of string values for a field
GenericFilters
object
ReadAudienceAttributes
object
Audience model representing audience details.
9 properties
4 required
UpsertMatchCriteriaRequestJsonApiModel
object
JSON API model for upsert match criteria request.
1 property
1 required
ZoominfoMatchColumn
object
Column model representing a ZoomInfo match column — values are populated by matching rows against ZoomInfo's database using defined criteria. This Column accep…
10 properties
8 required
AudienceFilterMetadataJsonApiModel
object
JSON API model for Audience filter metadata request.
1 property
1 required
ColumnDataDependencyListModel
object
JSON API model for list of column data dependencies supported for a specific column type.
1 property
1 required
ReadColumnListJsonApiModel
object
JSON API model for read Column.
1 property
1 required
ColumnAttributes
object
CUSTOM - Column model representing static column in an audience. FORMULA - Column model representing a formula-based column where values are generated from a p…
FolderJsonApiModelCreate
object
JSON API model for Folder.
1 property
1 required
ColumnUpdateJsonApiModel
object
JSON API model for Column update.
1 property
RowSearch
object
Row Get request resource.
2 properties
2 required
Audience
object
Audience request resource.
2 properties
2 required
FolderJsonApiList
object
JSON API model for Folder List.
3 properties
1 required
AudiencesJsonApiList
object
JSON API model for Audience list.
3 properties
1 required
UpdateFolder
object
Folder request resource.
2 properties
Operator
string
ReadColumn
object
Column Read resource model.
4 properties
3 required
AudienceJsonApiModel
object
JSON API model for Audience.
1 property
1 required
CreateAudienceResponseJsonApiModel
object
JSON API model for the Create Audience response.
1 property
1 required
RowJsonApiModel
object
JSON API model for Row.
1 property
1 required
JobStatusResponse
object
Job status resource.
3 properties
3 required
JobStatusResponseJsonApiModel
object
JSON API model for Job status response.
1 property
1 required
ZoomInfo.SearchCriteria.CompanySearch
object
Company search configuration.
62 properties
FormulaExpressionLanguage
string
Supported expression languages for formula columns.
RowAttributes
object
Contains all cell data for a row, organized as an array of CellDetails objects — one per column.
1 property
1 required
ColumnDataDependencyList
object
Resource model for list of column data dependencies supported for a specific column type.
2 properties
2 required
CellState
string
Processing state of a cell value within a row. Indicates whether enrichment has run and what the outcome was.
RunStatus
string
Terminal and in-progress states for an asynchronous job.
AudienceEnrichmentJsonApiModel
object
JSON API model for Audience enrichment request.
1 property
1 required
ScriptConfiguration
object
Optional script configuration returned for FORMULA columns. Contains the generated expression and its language.
2 properties
2 required
ReadAudienceJsonApiModel
object
JSON API model for Audience.
1 property
1 required
Column
object
Column Create request resource.
2 properties
2 required
ReadAudienceDetail
object
Audience read detail request resource.
4 properties
3 required
FilterMetadata
object
Filter metadata for a single column — lists which operators are valid and their constraints.
3 properties
3 required
ZoomInfoPublicApiAudienceAttributes
object
Audience model representing audience details.
8 properties
3 required
Pagination
object
Pagination details for paginated responses.
2 properties
2 required
ReadAudienceDetailJsonApiModel
object
JSON API model for Audience detail responses.
1 property
1 required
ReadColumnAttributes
object
Base attributes shared by all column types in an audience.
15 properties
7 required
UpdateAudience
object
Audience request resource.
2 properties
2 required
CreateColumnDuringAudienceCreationCreateItem
object
Column Create request resource model during audience creation. This model only includes attributes that are allowed during the creation of an audience, eg. Exc…
3 properties
2 required
UpdateFolderAttributes
object
Attributes for a folder that organizes audiences in GTM Studio.
4 properties
ColumnDataDependency
object
Defines a supported data dependency for a selected AI column type.
5 properties
4 required
JobResponseStatus
object
Current status and progress of an asynchronous job.
2 properties
1 required
AiTool
string
Defines AI tool names used by AI columns and data dependency discovery.
ContactsEmploymentHistory
object
Employment history criteria used in contact search.
2 properties
2 required
ColumnDataType
string
GenericFilterFieldForAudience
object
Represents a single filter field with its associated properties
4 properties
4 required
RowAsyncJob
object
Row async job response resource.
2 properties
2 required
FolderAttributes
object
Attributes for a folder that organizes audiences in GTM Studio.
5 properties
1 required
UpsertRow
object
Row attributes for upsert operations. Identical to RowAttributes but id is optional — omit it to create a new row, provide it to update an existing one.
3 properties
2 required
UpsertMatchCriteriaAttributes
object
Request attributes for upserting match criteria on the audience's designated match column. Match criteria define how audience column values are mapped to ZoomI…
1 property
ColumnMeta
object
Metadata for Column model.
6 properties
6 required
NumericArrayItem
array
Represents a list of numeric values for a field
ZoomInfo.Core.Foundations.ErrorModel
object
The object describing a specific error from the API
6 properties
3 required
AudiencesPagingLinks
object
Paging links for Audience list.
4 properties
AudienceMeta
object
Metadata for Audience model.
6 properties
6 required
GetRowsAttributes
object
Attributes defining the request parameters for retrieving Rows
2 properties
AudienceFilterMetadata
object
Audience filter metadata request resource.
3 properties
3 required
ZoomInfo.Core.Foundations.ErrorSourceModel
object
4 properties
EnrichAudienceAttributes
object
Defines the scope and targets for an enrichment operation. - If scope is AUDIENCE, enriches all rows; rows and columns are optional. - If scope is ROW, enriche…
3 properties
1 required
GenericFilterGroupForAudience
object
Represents a group of filters combined with a logical operator (AND/OR)
2 properties
1 required
MatchFields
string
EnrichJobJsonApiModel
object
JSON API model for Enrich job response.
1 property
1 required
AiColumn
object
Column model representing an AI column — values are generated by AI. The optional tool determines which AI capability is used.
13 properties
8 required
FilterOperatorConfig
object
Configuration constraints for a single filter operator on a column.
4 properties
2 required
DeleteRowJsonApiModel
object
Deleting Rows Request Models
1 property
1 required
GetRowsJsonApiModel
object
JSON API model for get Rows.
3 properties
1 required
AudienceAttributes
object
RowAsyncJobJsonApiModel
object
JSON API model for Row async job response.
1 property
1 required
CreateAudienceResponseAttributes
object
Audience attributes returned upon creation
10 properties
4 required
CellErrorDetails
object
Describes an error that occurred during enrichment for a specific cell.
3 properties
3 required
Folder
object
Folder request resource.
4 properties
3 required
ColumnJsonApiModel
object
JSON API model for create Column.
1 property
1 required
AudienceUpdateJsonApiModel
object
JSON API model for Audience.
1 property
1 required
ReadAudienceDetailAttributes
object
Audience attributes returned by detail endpoints.
10 properties
4 required
SourceOrigin
string
Indicates how the audience was originally populated. Read-only; set by the system based on the creation method.
UpdateColumn
object
Column update request resource.
2 properties
UpdateFolderJsonApiModel
object
JSON API model for Folder.
1 property
FolderMeta
object
Metadata for Folder model.
6 properties
6 required
ReadAudience
object
Audience read request resource.
4 properties
3 required
RowSearchPagingLinks
object
Paging links for get Rows.
4 properties
CellDetails
object
Defines the data and processing state for a single cell within a row.
4 properties
3 required
ColumnInputType
string
Defines the type of context input used for AI column generation.
RowSearchJsonApiModel
object
JSON API model for get Rows request.
1 property
1 required
FolderJsonApiModel
object
JSON API model for Folder.
1 property
1 required
ZoomInfo.SearchCriteria.ContactSearch
object
Contact search configuration.
88 properties
ColumnAttributesForAudienceCreate
object
Only Some columns can be created while creating an audience, so we are having a separate model to represent it For example ZoomInfo Match columns are created b…
RowIdentifier
object
Row Delete request resource.
2 properties
2 required
FilterMetadataAttributes
object
Filter metadata model representing the filter configuration and types allowed for each column.
1 property
1 required
FolderCreate
object
Folder request resource.
2 properties
2 required
FormulaColumn
object
Column model representing a formula column — values are generated by a formula prompt. Requires only name and prompt.
11 properties
8 required
GenericFilterOperator
string
UpdateColumnAttributes
object
Base attributes shared by all column types in an audience.
3 properties
ReadColumnJsonApiModel
object
JSON API model for read Column.
1 property
1 required
ColumnContextInput
object
Defines a context input for an AI column, referencing either an existing column in the audience or a knowledge base attribute. This context is used to inform t…
2 properties
2 required
AudienceType
string
Determines the record type the audience holds. Set at creation and cannot be changed.
CreateAudienceResponse
object
Audience response resource returned on creation.
4 properties
3 required
UpdateAudienceAttributes
object
Audience model representing audience details.
4 properties
UpsertRowsJsonApiModel
object
JSON API response for bulk row upsert. Returns created/updated rows in data[], matching the get row by ID response shape (includes state and errorDetails per c…
1 property
1 required
ZoomInfoSearchCriteria
object
ZoomInfo search criteria configuration for audience targeting. At least one of companySearch or contactSearch must be provided. - For COMPANY audiences, compan…
2 properties
Row
object
Attributes defining Row.
3 properties
3 required
CustomAudienceAttributes
object
Audience model representing audience details.
8 properties
3 required
ZoomInfo.Core.Foundations.ErrorResponseModel
object
The standard error response body model for the ZoomInfo API.
3 properties
1 required
NumericArray
array
Represents a list of numeric values for a field
AudienceUploadCreate
object
ZoomInfo Audience Upload
2 properties
2 required
AudienceUploadModel
object
Request/Response wrapper for a ZoomInfo Audience Upload
1 property
1 required
UploadOperationType
string
The type of upload
AudienceModel
object
Response containing a single ZoomInfo Audience
1 property
1 required
AudienceUpdate
object
ZoomInfo Audience
3 properties
3 required
GetAudiencesResponse
object
A paged list of ZoomInfo Audiences
3 properties
1 required
AudienceModelUpdate
object
Response containing a single ZoomInfo Audience
1 property
1 required
AudienceUploadModelCreate
object
Request/Response wrapper for a ZoomInfo Audience Upload
1 property
1 required
GetAudiencesMeta
object
Metadata for the current page of audiences returned
3 properties
3 required
AudienceUploadAttributes
object
Attributes defining an audience member upload
5 properties
4 required
AudienceAttributes_2
object
Attributes defining a ZoomInfo Audience
3 properties
3 required
AudienceType_2
string
UploadStatus
string
The various status values for an audience member upload
AudienceModelCreate
object
Response containing a single ZoomInfo Audience
1 property
1 required
Audience_2
object
ZoomInfo Audience
3 properties
3 required
AudienceAttributesUpdate
object
Attributes defining a ZoomInfo Audience
1 property
1 required
AudienceCreate
object
ZoomInfo Audience
2 properties
2 required
AudienceStatus
string
AudienceUpload
object
ZoomInfo Audience Upload
3 properties
3 required
AudienceUploadAttributesCreate
object
Attributes defining an audience member upload
3 properties
3 required
UploadField
string
Enumeration of allowed field names for records.
GetAudiencesLinks
object
Links describing the various audience paging options
3 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from ZoomInfo 12
Other APIs ZoomInfo publishes across the network.
ZoomInfo Authentication API
ZoomInfo Bulk API
ZoomInfo Company Enrich API
ZoomInfo Company Location Enrich API
ZoomInfo Company Master Data Enrich API
ZoomInfo Company Search API
ZoomInfo Compliance API
ZoomInfo Contact Enrich API
ZoomInfo Contact Search API
ZoomInfo Corporate Hierarchy Enrich API
ZoomInfo Hashtags Enrich API
ZoomInfo Intent Enrich API
#Audiences
Where this information came from
This is an independent, third-party profile of ZoomInfo Audiences API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.