ZoomInfo Audiences API
The Audiences API from ZoomInfo — 20 operation(s) for audiences.
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
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.
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}.
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}.
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}.
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.
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}.
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}.
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}.
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.
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}.
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}.
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}.
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}.
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}.
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}.
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}.