ZoomInfo

ZoomInfo Audiences API

The Audiences API from ZoomInfo — 20 operation(s) for audiences.

GitHub OpenAPI

Operations 30

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /studio/v1/folders Create a folder for audiences · Create New Folder #
Ask an LLM
“How do I create a folder to group audiences by campaign or region?”
“Can I add a description when I make a new GTM Studio folder?”
Tell an agent
Create a GTM Studio folder called {folder}.
Make a new folder {folder} to hold my event audiences.
GET /studio/v1/folders List GTM Studio folders · List Folders #
Ask an LLM
“Which folders do I have for organizing my GTM Studio audiences?”
“Can I find a folder by part of its name or by who created it?”
Tell an agent
List all my GTM Studio folders.
Find folders whose name contains {text}.
GET /studio/v1/folders/{folderId} Get a folder and its audiences · Get Specific Folder #
Ask an LLM
“Which audiences are inside a specific folder?”
“What are the notes and starred status on one of my folders?”
Tell an agent
Show folder {folderId}.
List the audience IDs contained in folder {folderId}.
PATCH /studio/v1/folders/{folderId} Rename or update a folder · Update Folder #
Ask an LLM
“Can I rename a folder or star it without changing anything else?”
“How do I edit the notes on an existing folder?”
Tell an agent
Rename folder {folderId} to {changes}.
Star folder {folderId}.
DELETE /studio/v1/folders/{folderId} Delete a folder and its audiences · Delete Specific Folder #
Ask an LLM
“Does deleting a folder also delete the audiences inside it?”
“Can I permanently remove a GTM Studio folder?”
Tell an agent destructive · confirm first
Delete folder {folderId}.
Permanently remove folder {folderId} and everything in it.
POST /studio/v1/audiences Create a GTM Studio audience · Create New Audience #
Ask an LLM
“How do I build a working list of contacts or companies for a campaign in GTM Studio?”
“Can I create an audience from trade show leads and match it automatically?”
Tell an agent
Create a GTM Studio audience {audience}.
Create a GTM Studio audience {audience} with automatic match criteria {auto}.
GET /studio/v1/audiences List GTM Studio audiences · List Audiences #
Ask an LLM
“Which GTM Studio audiences already exist so I don't create a duplicate?”
“Can I list only my company audiences, or only contact audiences?”
Tell an agent
List my GTM Studio audiences.
Find GTM Studio audiences whose name contains {text}.
GET /studio/v1/audiences/{audienceId} Get a GTM Studio audience and its columns · Fetch Audience #
Ask an LLM
“How many records are in one of my GTM Studio audiences?”
“What columns does a GTM Studio audience have?”
Tell an agent
Show GTM Studio audience {audienceId}.
Get the record count and column structure of audience {audienceId}.
DELETE /studio/v1/audiences/{audienceId} Delete a GTM Studio audience · Delete Audience #
Ask an LLM
“Can I permanently delete a GTM Studio audience with its rows and enrichment history?”
“Is deleting a GTM Studio audience reversible?”
Tell an agent destructive · confirm first
Delete GTM Studio audience {audienceId}.
Retire GTM Studio audience {audienceId} and remove all its rows.
PATCH /studio/v1/audiences/{audienceId} Rename or move a GTM Studio audience · Update Audience #
Ask an LLM
“How do I move a GTM Studio audience into a different folder?”
“Can I rename an audience or change its description in GTM Studio?”
Tell an agent
Update GTM Studio audience {audienceId} with {changes}.
Move audience {audienceId} to folder {changes}.
GET /studio/v1/audiences/{audienceId}/filter-metadata Get filter operators for an audience's columns · Get Audience Filter Metadata #
Ask an LLM
“Which filter operators like EQUALS or CONTAINS can I use on each column of an audience?”
“What can I filter on before querying rows in an audience?”
Tell an agent
Show the filter operators available for audience {audienceId}.
Tell me which columns of audience {audienceId} support CONTAINS filters.
POST /studio/v1/audiences/{audienceId}/actions/match-criteria Set how an audience's column is matched · Upsert Column Match Criteria #
Ask an LLM
“How do I tell ZoomInfo that my Email column should match on contact email?”
“Can I change the match criteria used to enrich an audience?”
Tell an agent
Set the match criteria for audience {audienceId} to {criteria}.
Map the match column of audience {audienceId} using {criteria}.
POST /studio/v1/audiences/{audienceId}/actions/enrich Enrich an audience with ZoomInfo data · Enrich Audience #
Ask an LLM
“How do I append ZoomInfo data to every row in an audience?”
“Can I enrich only specific rows of an audience instead of the whole thing?”
Tell an agent
Enrich all rows in audience {audienceId}.
Start an enrichment job on audience {audienceId} with scope {scope}.
GET /studio/v1/audiences/{audienceId}/jobs/{jobId} Check an audience job's progress · Get Job Status #
Ask an LLM
“Is the enrichment job on my audience finished yet?”
“What's the progress of a create, enrich or row upsert job?”
Tell an agent
Check job {jobId} on audience {audienceId}.
Tell me how far along job {jobId} is for audience {audienceId}.
POST /studio/v1/audiences/{audienceId}/columns/actions/bulk/create Add columns to an audience · Create New Columns #
Ask an LLM
“How do I define the columns an audience holds before loading rows?”
“Can I change a column's data type after I create it?”
Tell an agent
Add columns {columns} to audience {audienceId}.
Create an Email and a Company Name column in audience {audienceId}.
GET /studio/v1/audiences/{audienceId}/columns/data-dependencies/{tool} List data sources for an AI column · Get Column Data Dependencies #
Ask an LLM
“Which columns can an AI web research column use as context?”
“What data dependencies are valid for an AI emailer column in my audience?”
Tell an agent
List the data dependencies for {tool} in audience {audienceId}.
Show which context sources an AI_DATA_ANALYSIS column can use in audience {audienceId}.
PATCH /studio/v1/audiences/{audienceId}/columns/{columnId} Rename, freeze or hide a column · Update Column #
Ask an LLM
“How do I rename a column in an audience?”
“Can I freeze or hide a column in an audience view?”
Tell an agent
Rename column {columnId} in audience {audienceId} to {changes}.
Hide column {columnId} in audience {audienceId}.
DELETE /studio/v1/audiences/{audienceId}/columns/{columnId} Delete a column from an audience · Delete Column #
Ask an LLM
“Can I remove a column and all its values from an audience?”
“Why can't I delete some columns in an audience?”
Tell an agent destructive · confirm first
Delete column {columnId} from audience {audienceId}.
Remove column {columnId} and its cell values in audience {audienceId}.
GET /studio/v1/audiences/{audienceId}/rows/{rowId} Get one row from an audience · Get Row by ID #
Ask an LLM
“Did enrichment finish for a particular row in my audience?”
“Can I fetch a single audience row with only certain columns?”
Tell an agent
Get row {rowId} from audience {audienceId}.
Show columns {columns} of row {rowId} in audience {audienceId}.
POST /studio/v1/audiences/{audienceId}/rows/actions/search Query rows in an audience · List Rows #
Ask an LLM
“How do I filter and sort the rows in one of my audiences?”
“Which rows in an audience have enrichment errors or blank cells?”
Tell an agent
List rows in audience {audienceId} matching {filter}.
Show page {page} of rows in audience {audienceId} sorted by {sort}.
POST /studio/v1/audiences/{audienceId}/rows/actions/upsert Create or update up to 50 audience rows · Upsert Rows #
Ask an LLM
“Can I add or update a handful of rows in an audience in one synchronous call?”
“What's the limit on rows for the small, immediate upsert?”
Tell an agent
Upsert these rows {rows} into audience {audienceId} right away.
Update a few rows in audience {audienceId} with {rows}, 50 or fewer.
POST /studio/v1/audiences/{audienceId}/rows/actions/bulk/upsert Load up to 500 rows into an audience · Bulk Upsert Rows #
Ask an LLM
“How do I load a CRM export or trade show list into an audience?”
“Can I load hundreds of rows into an audience in one bulk call?”
Tell an agent
Bulk load {rows} into audience {audienceId}.
Import up to 500 leads {rows} into audience {audienceId} as a bulk upsert.
DELETE /studio/v1/audiences/{audienceId}/rows/actions/bulk/delete Delete rows from an audience · Delete Rows #
Ask an LLM
“Can I remove several rows from an audience at once?”
“Is deleting audience rows permanent?”
Tell an agent destructive · confirm first
Delete rows {rowIds} from audience {audienceId}.
Clean out rows {rowIds} in audience {audienceId}.
POST /marketing/v1/audiences Create a marketing audience · Creates a new audience #
Ask an LLM
“How do I create a new marketing audience?”
“Can I set up a marketing audience before uploading a segment to it?”
Tell an agent
Create a marketing audience {audience}.
Set up a new marketing audience named {audience}.
GET /marketing/v1/audiences List marketing audiences · Lists all audiences #
Ask an LLM
“Which marketing audiences do I have for ad targeting?”
“Can I page through my marketing audiences with a page token?”
Tell an agent
List my marketing audiences.
Get the next page of marketing audiences using token {pageToken}.
GET /marketing/v1/audiences/{audienceId} Get a marketing audience · Gets existing audience by ID #
Ask an LLM
“What are the settings of one marketing audience?”
“Can I look up a marketing audience by its ID?”
Tell an agent
Get marketing audience {audienceId}.
Show the details of marketing audience {audienceId}.
PUT /marketing/v1/audiences/{audienceId} Replace a marketing audience's settings · Updates audience by ID #
Ask an LLM
“How do I change an existing marketing audience?”
“Does updating a marketing audience overwrite the whole record?”
Tell an agent
Update marketing audience {audienceId} with {audience}.
Replace the settings of marketing audience {audienceId} with {audience}.
DELETE /marketing/v1/audiences/{audienceId} Delete a marketing audience · Deletes audience by ID #
Ask an LLM
“Can I delete a marketing audience I no longer use?”
“What happens when I remove a marketing audience?”
Tell an agent destructive · confirm first
Delete marketing audience {audienceId}.
Remove the marketing audience {audienceId} from my account.
POST /marketing/v1/audiences/{audienceId}/uploads Upload a segment to a marketing audience · Creates new audience upload #
Ask an LLM
“How do I upload a segment into a marketing audience?”
“Can I push a new list of records into an existing marketing audience?”
Tell an agent
Upload segment {segment} to marketing audience {audienceId}.
Start a new upload for marketing audience {audienceId} with {segment}.
GET /marketing/v1/audiences/{audienceId}/uploads/{uploadId} Check a marketing audience upload · Gets audience upload status #
Ask an LLM
“Did my segment upload to a marketing audience succeed?”
“What's the status of an audience upload I started?”
Tell an agent
Check upload {uploadId} for marketing audience {audienceId}.
Get the status of upload {uploadId} on audience {audienceId}.

Documentation

📖
Documentation
https://docs.zoominfo.com
📖
APIReference
https://docs.zoominfo.com/reference/api-overview

Specifications

⚙
OpenAPI
https://artifacts.apis.io/zoominfo/openapi/zoominfo-audiences-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-get-audiences-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-audiences-json-api-list-schema.json
📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-folder-json-api-list-schema.json
📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-get-rows-json-api-model-schema.json
📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-upsert-rows-json-api-model-schema.json
📊
JSONSchema
https://artifacts.apis.io/zoominfo/json-schema/zoominfo-row-upsert-list-api-model-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/zoominfo:zoominfo-audiences-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zoominfo-audiences-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Zoominfo Audiences API
  version: '1.0'
  contact:
    name: ZoomInfo Customer Support
    email: help@zoominfo.com
  description: 'Operations tagged Audiences across 2 of this provider''s published API definitions: zoominfo-gtm-gtm-studio-v1-openapi.json, zoominfo-gtm-marketing-v1-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.zoominfo.com/gtm
  description: Base URL for the GTM Studio API
security:
- OAuth2Auth: []
tags:


# --- truncated at 32 KB (203 KB total) ---
# Full source: https://artifacts.apis.io/zoominfo/openapi/zoominfo-audiences-api-openapi.yml