Studio API is one of 8 APIs that ZoomInfo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 6 JSON Schema definitions.
The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.
This API exposes 23 operations across 16 paths, and defines 117 schemas. It is described by OpenAPI 3.0.0, at version 1.0.
Requests are made against a single base URL, https://api.zoominfo.com/gtm.
23 operations
16 paths
117 schemas
4 DELETE8 GET3 PATCH8 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Studio 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 23
Across 16 paths, the API surfaces 23 operations — 4 DELETE, 8 GET, 3 PATCH, 8 POST. Each is listed below with its method, path, parameters, and response codes.
Audiences 23
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
POST
/studio/v1/audiences/{audienceId}/actions/enrich
Enrich Audience
POST
/studio/v1/audiences/{audienceId}/actions/match-criteria
Upsert Column Match Criteria
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}/filter-metadata
Get Audience Filter Metadata
GET
/studio/v1/audiences/{audienceId}/jobs/{jobId}
Get Job Status
DELETE
/studio/v1/audiences/{audienceId}/rows/actions/bulk/delete
Delete Rows
POST
/studio/v1/audiences/{audienceId}/rows/actions/bulk/upsert
Bulk Upsert Rows
POST
/studio/v1/audiences/{audienceId}/rows/actions/search
List Rows
POST
/studio/v1/audiences/{audienceId}/rows/actions/upsert
Upsert Rows
GET
/studio/v1/audiences/{audienceId}/rows/{rowId}
Get Row by ID
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
Schemas 117
The contract defines 117 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.
FolderAttributes
object
Attributes for a folder that organizes audiences in GTM Studio.
5 properties
1 required
FolderMeta
object
Metadata for Folder model.
6 properties
6 required
Folder
object
Folder request resource.
4 properties
3 required
FolderJsonApiModel
object
JSON API model for Folder.
1 property
1 required
ZoomInfo.Core.Foundations.ErrorSourceModel
object
4 properties
ZoomInfo.Core.Foundations.ErrorModel
object
The object describing a specific error from the API
6 properties
3 required
ZoomInfo.Core.Foundations.ErrorResponseModel
object
The standard error response body model for the ZoomInfo API.
3 properties
1 required
FolderCreate
object
Folder request resource.
2 properties
2 required
FolderJsonApiModelCreate
object
JSON API model for Folder.
1 property
1 required
Page
object
Page details for paginated responses.
2 properties
2 required
Pagination
object
Pagination details for paginated responses.
2 properties
2 required
FoldersPagingLinks
object
Paging links for Folder list.
4 properties
FolderJsonApiList
object
JSON API model for Folder List.
3 properties
1 required
UpdateFolderAttributes
object
Attributes for a folder that organizes audiences in GTM Studio.
4 properties
UpdateFolder
object
Folder request resource.
2 properties
UpdateFolderJsonApiModel
object
JSON API model for Folder.
1 property
AudienceType
string
Determines the record type the audience holds. Set at creation and cannot be changed.
SourceOrigin
string
Indicates how the audience was originally populated. Read-only; set by the system based on the creation method.
ColumnDataType
string
ColumnType
string
AiTool
string
Defines AI tool names used by AI columns and data dependency discovery.
ColumnInputType
string
Defines the type of context input used for AI column generation.
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
FormulaExpressionLanguage
string
Supported expression languages for formula columns.
ScriptConfiguration
object
Optional script configuration returned for FORMULA columns. Contains the generated expression and its language.
2 properties
2 required
MatchFields
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
ReadColumnAttributes
object
Base attributes shared by all column types in an audience.
15 properties
7 required
ColumnMeta
object
Metadata for Column model.
6 properties
6 required
ReadColumn
object
Column Read resource model.
4 properties
3 required
ZoomInfo.SearchCriteria.CompanySearch
object
Company search configuration.
62 properties
ContactsEmploymentHistory
object
Employment history criteria used in contact search.
2 properties
2 required
ZoomInfo.SearchCriteria.ContactSearch
object
Contact search configuration.
88 properties
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
CreateAudienceResponseAttributes
object
Audience attributes returned upon creation
10 properties
4 required
AudienceMeta
object
Metadata for Audience model.
6 properties
6 required
CreateAudienceResponse
object
Audience response resource returned on creation.
4 properties
3 required
CreateAudienceResponseJsonApiModel
object
JSON API model for the Create Audience response.
1 property
1 required
StaticColumn
object
Column model representing static column in an audience.
10 properties
8 required
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…
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
CustomAudienceAttributes
object
Audience model representing audience details.
8 properties
3 required
ZoomInfoPublicApiAudienceAttributes
object
Audience model representing audience details.
8 properties
3 required
AudienceAttributes
object
Audience
object
Audience request resource.
2 properties
2 required
AudienceJsonApiModel
object
JSON API model for Audience.
1 property
1 required
ReadAudienceAttributes
object
Audience model representing audience details.
9 properties
4 required
ReadAudience
object
Audience read request resource.
4 properties
3 required
AudiencesPagingLinks
object
Paging links for Audience list.
4 properties
AudiencesJsonApiList
object
JSON API model for Audience list.
3 properties
1 required
ReadAudienceDetailAttributes
object
Audience attributes returned by detail endpoints.
10 properties
4 required
ReadAudienceDetail
object
Audience read detail request resource.
4 properties
3 required
ReadAudienceDetailJsonApiModel
object
JSON API model for Audience detail responses.
1 property
1 required
ReadAudienceJsonApiModel
object
JSON API model for Audience.
1 property
1 required
UpdateAudienceAttributes
object
Audience model representing audience details.
4 properties
UpdateAudience
object
Audience request resource.
2 properties
2 required
AudienceUpdateJsonApiModel
object
JSON API model for Audience.
1 property
1 required
GenericFilterOperator
string
FilterOperatorConfig
object
Configuration constraints for a single filter operator on a column.
4 properties
2 required
FilterMetadata
object
Filter metadata for a single column — lists which operators are valid and their constraints.
3 properties
3 required
FilterMetadataAttributes
object
Filter metadata model representing the filter configuration and types allowed for each column.
1 property
1 required
AudienceFilterMetadata
object
Audience filter metadata request resource.
3 properties
3 required
AudienceFilterMetadataJsonApiModel
object
JSON API model for Audience filter metadata request.
1 property
1 required
ReadColumnJsonApiModel
object
JSON API model for read Column.
1 property
1 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
UpsertMatchCriteriaRequest
object
Upsert match criteria request resource.
3 properties
3 required
UpsertMatchCriteriaRequestJsonApiModel
object
JSON API model for upsert match criteria request.
1 property
1 required
EnrichJob
object
Enrich async job response resource.
2 properties
2 required
EnrichJobJsonApiModel
object
JSON API model for Enrich job response.
1 property
1 required
EnrichmentScope
string
Specifies the scope of enrichment operation: AUDIENCE enriches all rows, ROW enriches specific rows by ID.
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
EnrichAudience
object
Audience enrichment request resource.
2 properties
2 required
AudienceEnrichmentJsonApiModel
object
JSON API model for Audience enrichment request.
1 property
1 required
RunStatus
string
Terminal and in-progress states for an asynchronous job.
JobResponseStatus
object
Current status and progress of an asynchronous job.
2 properties
1 required
JobStatusResponse
object
Job status resource.
3 properties
3 required
JobStatusResponseJsonApiModel
object
JSON API model for Job status response.
1 property
1 required
ReadColumnListJsonApiModel
object
JSON API model for read Column.
1 property
1 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
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
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
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…
Column
object
Column Create request resource.
2 properties
2 required
ColumnJsonApiModel
object
JSON API model for create Column.
1 property
1 required
ColumnDataDependency
object
Defines a supported data dependency for a selected AI column type.
5 properties
4 required
ColumnDataDependencyList
object
Resource model for list of column data dependencies supported for a specific column type.
2 properties
2 required
ColumnDataDependencyListModel
object
JSON API model for list of column data dependencies supported for a specific column type.
1 property
1 required
UpdateColumnAttributes
object
Base attributes shared by all column types in an audience.
3 properties
UpdateColumn
object
Column update request resource.
2 properties
ColumnUpdateJsonApiModel
object
JSON API model for Column update.
1 property
StringArrayItem
array
Represents a list of string values for a field
NumericArrayItem
array
Represents a list of numeric values for a field
CellState
string
Processing state of a cell value within a row. Indicates whether enrichment has run and what the outcome was.
CellErrorDetails
object
Describes an error that occurred during enrichment for a specific cell.
3 properties
3 required
CellDetails
object
Defines the data and processing state for a single cell within a row.
4 properties
3 required
RowAttributes
object
Contains all cell data for a row, organized as an array of CellDetails objects — one per column.
1 property
1 required
Row
object
Attributes defining Row.
3 properties
3 required
RowJsonApiModel
object
JSON API model for Row.
1 property
1 required
RowSearchPagingLinks
object
Paging links for get Rows.
4 properties
GetRowsJsonApiModel
object
JSON API model for get Rows.
3 properties
1 required
Operator
string
StringArray
array
Represents a list of string values for a field
NumericArray
array
Represents a list of numeric values for a field
GenericFilterFieldForAudience
object
Represents a single filter field with its associated properties
4 properties
4 required
GenericFilters
object
GenericFilterGroupForAudience
object
Represents a group of filters combined with a logical operator (AND/OR)
2 properties
1 required
GetRowsAttributes
object
Attributes defining the request parameters for retrieving Rows
2 properties
RowSearch
object
Row Get request resource.
2 properties
2 required
RowSearchJsonApiModel
object
JSON API model for get Rows request.
1 property
1 required
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
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
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
RowAsyncJob
object
Row async job response resource.
2 properties
2 required
RowAsyncJobJsonApiModel
object
JSON API model for Row async job response.
1 property
1 required
RowIdentifier
object
Row Delete request resource.
2 properties
2 required
DeleteRowJsonApiModel
object
Deleting Rows Request Models
1 property
1 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
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from ZoomInfo 7
Other APIs ZoomInfo publishes across the network.
Agent API
Copilot API
Data API
Data Quality API
Marketing API
Platform API
Vertical Datasets API
Where this information came from
This is an independent, third-party profile of Studio 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.