ZoomInfo connector

OAuth 2.0CRM & SalesAnalyticsMarketing

Connect to ZoomInfo to search and enrich B2B contact and company data, access intent signals, discover technographic insights, and manage GTM Studio...

ZoomInfo connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Set up the connector
Section titled “Set up the connector”

Register your ZoomInfo credentials with Scalekit so it handles the token lifecycle. You do this once per environment.
Dashboard setup steps
Create a ZoomInfo OAuth app in the developer portal to get a client ID and client secret, then register your Scalekit redirect URI.
1. Create a ZoomInfo API app
  - Go to developer.zoominfo.com and sign in with your ZoomInfo account.
  - In the top-right corner, click + Create App.
2. Configure OAuth settings
  
  On the app creation form:
  - Enter an Application Name (e.g. Agent Auth).
  - Under OAuth, set the Redirect URI to your Scalekit redirect URI.
  - Copy the Client ID shown on the app settings page.
  - Click Show to reveal and copy the Client Secret.
3. Create a connection in Scalekit
  - In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
  - Search for ZoomInfo and click Create.
  - Enter the Client ID and Client Secret from your ZoomInfo app.
  - Note the Connection name — use this as connection_name in your code (e.g., zoominfo).

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'zoominfo'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize ZoomInfo:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'zoominfo_get_company_lookalikes',
25
  toolInput: {},
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "zoominfo"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize ZoomInfo:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="zoominfo_get_company_lookalikes",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Settings upsert — Create or update the customer settings singleton for the authenticated ZoomInfo account
Segment upsert, unarchive, archive — Create a new Ideal Customer Profile (ICP) or update an existing one
Offering upsert, unarchive, archive — Create a new product/service or update an existing one
Interactions upsert content — Create or update a content interaction engagement record (website visit, email click, form submission, etc.)
Competitor upsert, unarchive, archive — Create a new competitor record or update an existing one
Persona upsert buyer, unarchive buyer, archive buyer — Create a new buyer persona or update an existing one

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

zoominfo_archive_buyer_persona#Archive a buyer persona to hide it from active use without permanently deleting it. The persona can be unarchived later. Use this instead of delete when you may need to restore the persona.3 params

Archive a buyer persona to hide it from active use without permanently deleting it. The persona can be unarchived later. Use this instead of delete when you may need to restore the persona.

NameTypeRequiredDescription

buyerPersonaIdstringrequiredUUID of the buyer persona.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_archive_competitor#Archive a competitor to hide it from active use without permanently deleting it. The record can be restored later using Unarchive Competitor.3 params

Archive a competitor to hide it from active use without permanently deleting it. The record can be restored later using Unarchive Competitor.

NameTypeRequiredDescription

competitorIdstringrequiredUUID of the competitor.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_archive_offering#Archive a product or service to hide it from active use without deleting it. Reversible with Unarchive.3 params

Archive a product or service to hide it from active use without deleting it. Reversible with Unarchive.

NameTypeRequiredDescription

offeringIdstringrequiredUUID of the product or service.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_archive_segment#Archive an ICP to hide it from active use without permanently deleting it. Reversible with Unarchive ICP.3 params

Archive an ICP to hide it from active use without permanently deleting it. Reversible with Unarchive ICP.

NameTypeRequiredDescription

segmentIdstringrequiredUUID of the ICP segment.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_ask_account_summary#Ask a natural language question about a company's account summary. Returns an AI-generated answer using ZoomInfo's account intelligence data. Requires a ZoomInfo company ID and a question.4 params

Ask a natural language question about a company's account summary. Returns an AI-generated answer using ZoomInfo's account intelligence data. Requires a ZoomInfo company ID and a question.

NameTypeRequiredDescription

companyIdintegerrequiredZoomInfo unique company ID.

questionstringrequiredThe question to ask about the company's account data.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_create_audience#Create a new GTM Studio audience — a collection of contacts or companies for marketing and sales. Only CUSTOM source audiences are supported. Optionally define columns at creation or add them later. If folderId is omitted, a new folder matching the audience name is created automatically.9 params

Create a new GTM Studio audience — a collection of contacts or companies for marketing and sales. Only CUSTOM source audiences are supported. Optionally define columns at creation or add them later. If folderId is omitted, a new folder matching the audience name is created automatically.

NameTypeRequiredDescription

namestringrequiredRequired. Display name of the audience.

typestringrequiredRecord type the audience holds (CONTACT or COMPANY).

autoMatchCriteriabooleanoptionalEnable AI auto-mapping of column match criteria.

columnsarrayoptionalColumn definitions to add to the audience at creation.

descriptionstringoptionalOptional description of the audience's purpose.

folderIdstringoptionalUUID of the folder to place this audience in. If omitted, a new folder matching the audience name is created automatically.

notesstringoptionalOptional internal notes about the audience.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_create_audience_columns#Add one or more columns to an existing audience in a single bulk operation. Supports CUSTOM (static), FORMULA, AI, and ZOOMINFO_MATCH column types. Returns 201 with created column IDs.4 params

Add one or more columns to an existing audience in a single bulk operation. Supports CUSTOM (static), FORMULA, AI, and ZOOMINFO_MATCH column types. Returns 201 with created column IDs.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience to add columns to.

columnsarrayrequiredArray of column definitions to create.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_create_folder#Create a new folder for organizing audiences in ZoomInfo GTM Studio. Folders group related audiences by campaign, region, or team. The folder is created empty — assign audiences via Create Audience or Update Audience using the returned folderId.6 params

Create a new folder for organizing audiences in ZoomInfo GTM Studio. Folders group related audiences by campaign, region, or team. The folder is created empty — assign audiences via Create Audience or Update Audience using the returned folderId.

NameTypeRequiredDescription

namestringrequiredDisplay name of the folder.

descriptionstringoptionalOptional description of the folder's purpose.

notesstringoptionalOptional internal notes about the folder.

schema_versionstringoptionalSchema version override

starredbooleanoptionalWhether the folder is starred for quick access.

tool_versionstringoptionalTool version override

zoominfo_create_marketing_audience#Create a new ZoomInfo marketing audience for B2B or B2C targeting. Marketing audiences are separate from GTM Studio audiences.4 params

Create a new ZoomInfo marketing audience for B2B or B2C targeting. Marketing audiences are separate from GTM Studio audiences.

NameTypeRequiredDescription

audienceTypestringrequiredAudience type — B2B or B2C.

namestringrequiredName of the audience.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_audience#Permanently delete an audience by UUID. Removes all rows, columns, and configuration. This action is irreversible. Returns 204 on success.3 params

Permanently delete an audience by UUID. Removes all rows, columns, and configuration. This action is irreversible. Returns 204 on success.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_audience_column#Permanently remove a column from an audience, including all cell values in that column across every row. Only columns where isDeletable=true can be removed. This action is irreversible. Returns 204 on success.4 params

Permanently remove a column from an audience, including all cell values in that column across every row. Only columns where isDeletable=true can be removed. This action is irreversible. Returns 204 on success.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

columnIdstringrequiredUUID of the column to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_audience_rows#Permanently delete up to 1000 rows from an audience in one bulk operation. This is an async operation — returns 202 with a jobId. Poll Get Audience Job Status to confirm deletion. Cannot be undone.4 params

Permanently delete up to 1000 rows from an audience in one bulk operation. This is an async operation — returns 202 with a jobId. Poll Get Audience Job Status to confirm deletion. Cannot be undone.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

rowIdsarrayrequiredArray of row IDs to permanently delete (max 1000).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_buyer_persona#Permanently delete a buyer persona by UUID. This is a hard delete — the persona cannot be recovered. Returns 204 on success, 404 if not found. Use Archive Buyer Persona instead if you want to hide it without deleting.3 params

Permanently delete a buyer persona by UUID. This is a hard delete — the persona cannot be recovered. Returns 204 on success, 404 if not found. Use Archive Buyer Persona instead if you want to hide it without deleting.

NameTypeRequiredDescription

buyerPersonaIdstringrequiredUUID of the buyer persona to permanently delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_delete_competitor#Permanently delete a competitor record by UUID. This is a hard delete and cannot be undone. Returns 204 on success. Use Archive Competitor to hide without deleting.3 params

Permanently delete a competitor record by UUID. This is a hard delete and cannot be undone. Returns 204 on success. Use Archive Competitor to hide without deleting.

NameTypeRequiredDescription

competitorIdstringrequiredUUID of the competitor to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_delete_content_interaction#Delete a content interaction engagement record by ID. Returns 204 on success.3 params

Delete a content interaction engagement record by ID. Returns 204 on success.

NameTypeRequiredDescription

idstringrequiredRequired. Unique identifier of the content interaction to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_folder#Permanently delete a folder by its UUID. Returns 204 on success. Audiences inside the folder are not deleted — they are unassigned from the folder.3 params

Permanently delete a folder by its UUID. Returns 204 on success. Audiences inside the folder are not deleted — they are unassigned from the folder.

NameTypeRequiredDescription

folderIdstringrequiredUUID of the folder to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_marketing_audience#Permanently delete a ZoomInfo marketing audience by ID. Returns 204 on success.3 params

Permanently delete a ZoomInfo marketing audience by ID. Returns 204 on success.

NameTypeRequiredDescription

audienceIdstringrequiredID of the audience to delete.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_offering#Permanently delete a product or service by UUID. Hard delete — cannot be undone. Returns 204.3 params

Permanently delete a product or service by UUID. Hard delete — cannot be undone. Returns 204.

NameTypeRequiredDescription

offeringIdstringrequiredUUID of the product or service.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_delete_segment#Permanently delete an ICP by UUID. Hard delete — cannot be undone. Returns 204 on success.3 params

Permanently delete an ICP by UUID. Hard delete — cannot be undone. Returns 204 on success.

NameTypeRequiredDescription

segmentIdstringrequiredUUID of the ICP segment.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_delete_settings#Permanently delete all customer settings for the authenticated ZoomInfo account. This removes the company name, elevator pitch, description, and strategic priorities. Returns 204 on success.2 params

Permanently delete all customer settings for the authenticated ZoomInfo account. This removes the company name, elevator pitch, description, and strategic priorities. Returns 204 on success.

NameTypeRequiredDescription

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_enrich_audience#Start an async enrichment job to append ZoomInfo intelligence to audience rows. Use scope=AUDIENCE to enrich all rows, or scope=ROW with specific rowIds. Returns 202 with a jobId to poll via Get Audience Job Status.6 params

Start an async enrichment job to append ZoomInfo intelligence to audience rows. Use scope=AUDIENCE to enrich all rows, or scope=ROW with specific rowIds. Returns 202 with a jobId to poll via Get Audience Job Status.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience to enrich.

scopestringrequiredEnrichment scope.

columnsarrayoptionalColumn IDs to enrich (optional for any scope).

rowsarrayoptionalRow IDs to enrich (required when scope=ROW).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_enrich_companies#Enrich up to 25 company records with detailed ZoomInfo firmographic data including revenue, headcount, industry, technographics, and more. Specify output fields and provide match criteria (companyId, name, or website). Each matched record consumes a credit. Use Search Companies first to get companyIds for best match accuracy.5 params

Enrich up to 25 company records with detailed ZoomInfo firmographic data including revenue, headcount, industry, technographics, and more. Specify output fields and provide match criteria (companyId, name, or website). Each matched record consumes a credit. Use Search Companies first to get companyIds for best match accuracy.

NameTypeRequiredDescription

matchCompanyInputarrayrequiredList of up to 25 companies to match and enrich.

outputFieldsarrayrequiredFields to include in the response for each enriched company.

requiredFieldsarrayoptionalFields that must be present in the result for a record to be returned.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_enrich_contacts#Enrich up to 25 contact records with detailed ZoomInfo data including emails, phone numbers, job titles, and company details. Specify output fields to return and provide match criteria (personId, email, name, or phone). Each matched record consumes a credit. Use Search Contacts first to get personIds for best match accuracy.5 params

Enrich up to 25 contact records with detailed ZoomInfo data including emails, phone numbers, job titles, and company details. Specify output fields to return and provide match criteria (personId, email, name, or phone). Each matched record consumes a credit. Use Search Contacts first to get personIds for best match accuracy.

NameTypeRequiredDescription

matchPersonInputarrayrequiredList of up to 25 contacts to match and enrich. Each object can include personId, email, name, phone, or company details.

outputFieldsarrayrequiredFields to include in the response for each enriched contact.

requiredFieldsarrayoptionalFields that must be present in the result for a record to be returned.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_enrich_corporate_hierarchy#Enrich the corporate hierarchy for up to 25 companies. Returns the full family tree including parent company, subsidiaries, acquisitions, former names, and known locations. If the matched company is not the top-level parent, also returns all parent companies up to the ultimate parent. Each matched record consumes a credit.4 params

Enrich the corporate hierarchy for up to 25 companies. Returns the full family tree including parent company, subsidiaries, acquisitions, former names, and known locations. If the matched company is not the top-level parent, also returns all parent companies up to the ultimate parent. Each matched record consumes a credit.

NameTypeRequiredDescription

matchCompanyInputarrayrequiredList of up to 25 companies to match and retrieve hierarchy for.

outputFieldsarrayrequiredFields to include in the response for each enriched company hierarchy.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_enrich_hashtags#Get categorical hashtag labels for a specific company by ZoomInfo company ID. Hashtags classify companies based on business characteristics, technologies, and attributes — useful for precise filtering and segmentation. Charges one credit for the enriched company.3 params

Get categorical hashtag labels for a specific company by ZoomInfo company ID. Hashtags classify companies based on business characteristics, technologies, and attributes — useful for precise filtering and segmentation. Charges one credit for the enriched company.

NameTypeRequiredDescription

companyIdintegerrequiredZoomInfo unique company ID.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_enrich_intent#Fetch buying intent signals for a specific company by providing up to 50 intent topics. At least one company identifier (companyId, companyName, or companyWebsite) and at least one topic are required. Returns signal score, audience strength, and optional recommended contacts. Charges one credit for the company plus record credits per signal returned.16 params

Fetch buying intent signals for a specific company by providing up to 50 intent topics. At least one company identifier (companyId, companyName, or companyWebsite) and at least one topic are required. Returns signal score, audience strength, and optional recommended contacts. Charges one credit for the company plus record credits per signal returned.

NameTypeRequiredDescription

topicsarrayrequiredArray of up to 50 intent topic names to fetch signals for.

audienceStrengthMaxstringoptionalMaximum audience strength (A-E, where A = largest audience).

audienceStrengthMinstringoptionalMinimum audience strength (A-E, where A = largest audience).

companyIdintegeroptionalZoomInfo unique company ID. Provide at least one of companyId, companyName, or companyWebsite.

companyNamestringoptionalCompany name. Provide at least one of companyId, companyName, or companyWebsite.

companyWebsitestringoptionalCompany website URL. Provide at least one of companyId, companyName, or companyWebsite.

findRecommendedContactsbooleanoptionalSet to false to exclude recommended contacts from results. Default is true.

pageNumberintegeroptionalPage number for pagination, starting from 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

schema_versionstringoptionalSchema version override

signalEndDatestringoptionalEnd date for intent signals in YYYY-MM-DD format.

signalScoreMaxintegeroptionalMaximum signal score (60-100).

signalScoreMinintegeroptionalMinimum signal score (60-100).

signalStartDatestringoptionalStart date for intent signals in YYYY-MM-DD format.

sortstringoptionalSort field. Valid values: audiencestrength, category, companyname, issuedate, signaldate, signalscore, signalstrength, surgescore, topic. Prefix with - for descending.

tool_versionstringoptionalTool version override

zoominfo_enrich_news#Fetch news articles for a specific company by providing at least one company identifier (companyId, companyName, or companyWebsite). Optionally filter by news category, URL, and date range. Charges one credit for the enriched company plus record credits per article returned. Use Search News to find articles across all companies.11 params

Fetch news articles for a specific company by providing at least one company identifier (companyId, companyName, or companyWebsite). Optionally filter by news category, URL, and date range. Charges one credit for the enriched company plus record credits per article returned. Use Search News to find articles across all companies.

NameTypeRequiredDescription

categoriesarrayoptionalNews article categories to filter by.

companyIdintegeroptionalZoomInfo unique company ID.

companyNamestringoptionalCompany name.

companyWebsitestringoptionalCompany website URL.

pageDateMaxstringoptionalLatest publishing date for news articles.

pageDateMinstringoptionalEarliest publishing date for news articles.

pageNumberintegeroptionalPage number for pagination.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

urlarrayoptionalNews article URLs to filter by.

zoominfo_enrich_org_charts#Get org chart data for a company by department. Returns ZoomInfo contacts organized by seniority level within the specified department(s). Requires a ZoomInfo company ID and at least one department. Charges one credit per request regardless of contacts returned.9 params

Get org chart data for a company by department. Returns ZoomInfo contacts organized by seniority level within the specified department(s). Requires a ZoomInfo company ID and at least one department. Charges one credit per request regardless of contacts returned.

NameTypeRequiredDescription

companyIdstringrequiredZoomInfo company ID to get org chart for.

departmentstringrequiredComma-separated department IDs to get org chart data for.

contactAccuracyScoreMaxstringoptionalMaximum contact accuracy score (70-99).

contactAccuracyScoreMinstringoptionalMinimum contact accuracy score (70-99).

pageNumberintegeroptionalPage number for pagination.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

sortstringoptionalSort field.

tool_versionstringoptionalTool version override

zoominfo_enrich_scoops#Fetch scoops (business intelligence signals) for a specific company. At least one company identifier (companyId, companyName, or companyWebsite) is required. Optionally filter by scoop type, topic, department, and date range. Charges one credit for the enriched company plus record credits per scoop returned.16 params

Fetch scoops (business intelligence signals) for a specific company. At least one company identifier (companyId, companyName, or companyWebsite) is required. Optionally filter by scoop type, topic, department, and date range. Charges one credit for the enriched company plus record credits per scoop returned.

NameTypeRequiredDescription

companyIdstringoptionalZoomInfo company ID.

companyNamestringoptionalCompany name.

companyWebsitestringoptionalCompany website URL.

departmentstringoptionalDepartment associated with the scoop.

descriptionstringoptionalKeywords to search in scoop descriptions.

pageNumberintegeroptionalPage number.

pageSizeintegeroptionalResults per page.

publishedEndDatestringoptionalEnd date for scoop publication range.

publishedStartDatestringoptionalStart date for scoop publication range.

schema_versionstringoptionalSchema version override

scoopIdstringoptionalZoomInfo scoop ID.

scoopTopicstringoptionalScoop topic IDs.

scoopTypestringoptionalScoop type IDs.

sortstringoptionalSort field.

tool_versionstringoptionalTool version override

updatedSinceCreationbooleanoptionalReturn only scoops updated since publishedStartDate.

zoominfo_enrich_technologies#Get the technology stack for a specific company by ZoomInfo company ID. Returns technologies identified through website analysis, job postings, company announcements, and data partnerships. Charges one credit for the enriched company.3 params

Get the technology stack for a specific company by ZoomInfo company ID. Returns technologies identified through website analysis, job postings, company announcements, and data partnerships. Charges one credit for the enriched company.

NameTypeRequiredDescription

companyIdintegerrequiredZoomInfo unique company ID.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_account_summary#Get an AI-generated account summary for a specific company including recent news, intent signals, key contacts, and strategic priorities. Requires a ZoomInfo company ID.3 params

Get an AI-generated account summary for a specific company including recent news, intent signals, key contacts, and strategic priorities. Requires a ZoomInfo company ID.

NameTypeRequiredDescription

companyIdintegerrequiredZoomInfo unique company ID.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_agent_team#Get full details for an Agent Team by ID including configured input parameters required when running it. Use List Agent Teams to find the agentTeamId.3 params

Get full details for an Agent Team by ID including configured input parameters required when running it. Use List Agent Teams to find the agentTeamId.

NameTypeRequiredDescription

agentTeamIdstringrequiredRequired. Unique identifier of the Agent Team.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_agent_team_run_results#Get the status and results of a specific Agent Team run by agentTeamId and runId. Poll this endpoint after triggering a run to monitor progress.4 params

Get the status and results of a specific Agent Team run by agentTeamId and runId. Poll this endpoint after triggering a run to monitor progress.

NameTypeRequiredDescription

agentTeamIdstringrequiredRequired. Unique identifier of the Agent Team.

runIdstringrequiredRequired. Unique identifier of the run returned by Run Agent Team.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_audience#Retrieve the full state of a single audience by UUID. Returns name, type, origin, record count, folder location, timestamps, and complete column structure. Returns 404 if not found.3 params

Retrieve the full state of a single audience by UUID. Returns name, type, origin, record count, folder location, timestamps, and complete column structure. Returns 404 if not found.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_audience_filter_metadata#Get available filter operators for each column in an audience. Returns operator types (EQUALS, CONTAINS, NOT_EQUALS, etc.), whether multiple values are supported, value count limits, and minimum character requirements. Use before building row queries to validate filter inputs.3 params

Get available filter operators for each column in an audience. Returns operator types (EQUALS, CONTAINS, NOT_EQUALS, etc.), whether multiple values are supported, value count limits, and minimum character requirements. Use before building row queries to validate filter inputs.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience to get filter metadata for.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_audience_job_status#Get the current status and progress of an async audience job (AUDIENCE_CREATE, AUDIENCE_ENRICH, or ROW_UPSERT). Status values: SCHEDULED, RUNNING, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, CANCELLED. Returns percentProgress. Use jobId returned by the originating operation.4 params

Get the current status and progress of an async audience job (AUDIENCE_CREATE, AUDIENCE_ENRICH, or ROW_UPSERT). Status values: SCHEDULED, RUNNING, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, CANCELLED. Returns percentProgress. Use jobId returned by the originating operation.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience the job belongs to.

jobIdstringrequiredUUID of the async job to check.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_audience_row#Retrieve a single row from an audience by rowId. Returns all cell values with their state (RESULT, BLANK, LOADING, ERROR, NO_RESULT). Optionally limit response to specific columns.5 params

Retrieve a single row from an audience by rowId. Returns all cell values with their state (RESULT, BLANK, LOADING, ERROR, NO_RESULT). Optionally limit response to specific columns.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

rowIdstringrequiredUUID of the row to retrieve.

columnsarrayoptionalColumn IDs to include in the response.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_buyer_persona#Retrieve a single buyer persona by its UUID. Returns full persona configuration including role, objectives, messaging angles, and custom fields. Returns 404 if the persona does not exist.3 params

Retrieve a single buyer persona by its UUID. Returns full persona configuration including role, objectives, messaging angles, and custom fields. Returns 404 if the persona does not exist.

NameTypeRequiredDescription

buyerPersonaIdstringrequiredUUID of the buyer persona to retrieve.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_column_data_dependencies#Get available data dependencies for AI-powered audience columns. Returns which audience columns and knowledge sources can be used as context for the selected AI tool type. Use before creating AI columns to discover valid grounding sources.4 params

Get available data dependencies for AI-powered audience columns. Returns which audience columns and knowledge sources can be used as context for the selected AI tool type. Use before creating AI columns to discover valid grounding sources.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

toolstringrequiredAI tool type to get data dependencies for.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_company_lookalikes#Find up to 100 companies similar to a reference company using ZoomInfo's ML model. Analyzes industry, revenue, headcount, and firmographic signals to rank lookalikes by similarity score. Provide companyId for best results, or companyName if the ID is unavailable. Results are ordered from most to least similar.4 params

Find up to 100 companies similar to a reference company using ZoomInfo's ML model. Analyzes industry, revenue, headcount, and firmographic signals to rank lookalikes by similarity score. Provide companyId for best results, or companyName if the ID is unavailable. Results are ordered from most to least similar.

NameTypeRequiredDescription

filter_companyIdstringoptionalZoomInfo unique company ID to use as the reference for finding lookalikes.

filter_companyNamestringoptionalName of the reference company to find lookalikes for.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_competitor#Retrieve a single competitor record by its UUID. Returns full competitive intelligence including products, win/loss analysis, and displacement scenarios. Returns 404 if not found.3 params

Retrieve a single competitor record by its UUID. Returns full competitive intelligence including products, win/loss analysis, and displacement scenarios. Returns 404 if not found.

NameTypeRequiredDescription

competitorIdstringrequiredUUID of the competitor.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_contact_lookalikes#Find up to 100 contacts similar to a reference person using ZoomInfo's ML model. Matches on title, seniority, department, and company attributes. Optionally scope the search to a specific target company. Returns results ordered from most to least similar by score.5 params

Find up to 100 contacts similar to a reference person using ZoomInfo's ML model. Matches on title, seniority, department, and company attributes. Optionally scope the search to a specific target company. Returns results ordered from most to least similar by score.

NameTypeRequiredDescription

filter_referencePersonIdintegerrequiredZoomInfo person ID of the reference contact to find lookalikes for.

filter_targetCompanyIdintegeroptionalConstrain lookalike search to a specific target company.

page_sizeintegeroptionalNumber of lookalike contacts to return (1-100).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_contact_recommendations#Get up to 100 ranked contact recommendations at a target company for a specific sales motion (prospecting, deal acceleration, or renewal and growth). Uses ML to surface the most relevant personas based on past user interactions, CRM data, and engagement signals. Results are ordered from most to least relevant.5 params

Get up to 100 ranked contact recommendations at a target company for a specific sales motion (prospecting, deal acceleration, or renewal and growth). Uses ML to surface the most relevant personas based on past user interactions, CRM data, and engagement signals. Results are ordered from most to least relevant.

NameTypeRequiredDescription

filter_useCaseTypestringrequiredSales motion type to drive recommendations.

filter_ziCompanyIdintegerrequiredZoomInfo company ID of the target account to get contact recommendations for.

page_sizeintegeroptionalNumber of recommendations to return (1-100).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_content_interaction#Retrieve a specific content interaction engagement by its ID.3 params

Retrieve a specific content interaction engagement by its ID.

NameTypeRequiredDescription

idstringrequiredRequired. Unique identifier of the content interaction engagement.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_folder#Retrieve a single folder by its UUID. Returns all attributes including name, starred status, description, notes, timestamps, and the list of audience IDs in the folder. Returns 404 if not found.3 params

Retrieve a single folder by its UUID. Returns all attributes including name, starred status, description, notes, timestamps, and the list of audience IDs in the folder. Returns 404 if not found.

NameTypeRequiredDescription

folderIdstringrequiredUUID of the folder.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_insights#Retrieve sales intelligence signals (insights) for up to 50 companies, filtered by signal type. Insights include funding events, leadership changes, intent spikes, hiring anomalies, website visits, and more. Signals are filtered for relevance and recency based on your team's focus areas.4 params

Retrieve sales intelligence signals (insights) for up to 50 companies, filtered by signal type. Insights include funding events, leadership changes, intent spikes, hiring anomalies, website visits, and more. Signals are filtered for relevance and recency based on your team's focus areas.

NameTypeRequiredDescription

ziCompanyIdsarrayrequiredList of ZoomInfo company IDs to retrieve insights for (max 50).

schema_versionstringoptionalSchema version override

signalTypesarrayoptionalOptional filter for specific insight/signal types. Returns all types if omitted.

tool_versionstringoptionalTool version override

zoominfo_get_marketing_audience#Retrieve a single ZoomInfo marketing audience by its ID.3 params

Retrieve a single ZoomInfo marketing audience by its ID.

NameTypeRequiredDescription

audienceIdstringrequiredID of the marketing audience.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_marketing_audience_upload_status#Get the upload status for a previously submitted marketing audience upload job. Returns the current status and progress.4 params

Get the upload status for a previously submitted marketing audience upload job. Returns the current status and progress.

NameTypeRequiredDescription

audienceIdstringrequiredID of the marketing audience.

uploadIdstringrequiredID of the upload job.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_offering#Retrieve a single product or service by UUID. Returns full configuration including positioning, pain points, and value proposition. Returns 404 if not found.3 params

Retrieve a single product or service by UUID. Returns full configuration including positioning, pain points, and value proposition. Returns 404 if not found.

NameTypeRequiredDescription

offeringIdstringrequiredUUID of the product or service.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_get_segment#Retrieve a single ICP by its UUID. Returns full profile configuration. Returns 404 if not found.3 params

Retrieve a single ICP by its UUID. Returns full profile configuration. Returns 404 if not found.

NameTypeRequiredDescription

segmentIdstringrequiredUUID of the ICP segment.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_settings#Retrieve the customer settings for the authenticated ZoomInfo customer. Settings include company name, description, elevator pitch, and strategic GTM priorities used to power AI recommendations. Returns 404 if no settings have been configured yet.2 params

Retrieve the customer settings for the authenticated ZoomInfo customer. Settings include company name, description, elevator pitch, and strategic GTM priorities used to power AI recommendations. Returns 404 if no settings have been configured yet.

NameTypeRequiredDescription

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_get_usage#Get the current user's API usage statistics and limits including credits consumed, records returned, and request counts. Use this to monitor consumption against your ZoomInfo plan limits.2 params

Get the current user's API usage statistics and limits including credits consumed, records returned, and request counts. Use this to monitor consumption against your ZoomInfo plan limits.

NameTypeRequiredDescription

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_list_agent_team_runs#List all runs for an Agent Team, sorted in reverse chronological order. Use Get Agent Team Results to poll for status of a specific run.5 params

List all runs for an Agent Team, sorted in reverse chronological order. Use Get Agent Team Results to poll for status of a specific run.

NameTypeRequiredDescription

agentTeamIdstringrequiredRequired. Unique identifier of the Agent Team.

pageNumberintegeroptionalPage number for pagination. Default is 1.

pageSizeintegeroptionalResults per page (1-100). Default is 25.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_list_agent_teams#List all Agent Teams with optional filtering and sorting. Returns team names, registered triggers, and active status.6 params

List all Agent Teams with optional filtering and sorting. Returns team names, registered triggers, and active status.

NameTypeRequiredDescription

filter_namestringoptionalFilter agent teams by name.

pageNumberintegeroptionalPage number for pagination. Default is 1.

pageSizeintegeroptionalResults per page (1-100). Default is 25.

schema_versionstringoptionalSchema version override

sortstringoptionalSort field. Valid values: name, createdAt, updatedAt. Prefix with - for descending.

tool_versionstringoptionalSchema version override

zoominfo_list_audience_rows#Search and list rows in an audience with optional filtering, sorting, and pagination. Supports complex filter groups with AND/OR logic. Optionally retrieve specific row IDs. Returns up to 500 rows per page.9 params

Search and list rows in an audience with optional filtering, sorting, and pagination. Supports complex filter groups with AND/OR logic. Optionally retrieve specific row IDs. Returns up to 500 rows per page.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

columnsarrayoptionalColumn IDs to include in response.

filterobjectoptionalFilter group with logical operator and filter conditions.

idsarrayoptionalSpecific row IDs to retrieve.

pageNumberintegeroptionalPage number.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

sortstringoptionalColumn ID to sort by.

tool_versionstringoptionalSchema version override

zoominfo_list_audiences#List all GTM Studio audiences with optional filtering and sorting. Use this to browse audiences or find an audienceId before operating on rows, columns, or enrichment.7 params

List all GTM Studio audiences with optional filtering and sorting. Use this to browse audiences or find an audienceId before operating on rows, columns, or enrichment.

NameTypeRequiredDescription

filter_searchTextstringoptionalFilter audiences by name using a case-insensitive contains match.

filter_typestringoptionalFilter by audience record type.

pageNumberintegeroptionalPage number for pagination. Default is 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

schema_versionstringoptionalSchema version override

sortstringoptionalSort field. Valid values: name, createdAt, updatedAt, recordCount. Prefix with - for descending. Default: -updatedAt.

tool_versionstringoptionalTool version override

zoominfo_list_buyer_personas#List all buyer personas configured for the authenticated ZoomInfo customer. Buyer personas represent ideal buyer profiles including role, objectives, and purchasing motivations. Use this to discover persona IDs for use in other API operations.2 params

List all buyer personas configured for the authenticated ZoomInfo customer. Buyer personas represent ideal buyer profiles including role, objectives, and purchasing motivations. Use this to discover persona IDs for use in other API operations.

NameTypeRequiredDescription

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_list_competitors#List all competitors configured for the authenticated ZoomInfo customer. Competitor records capture competitive intelligence including competing products, win/loss analysis, and displacement history. Use this to discover competitor IDs for other operations.4 params

List all competitors configured for the authenticated ZoomInfo customer. Competitor records capture competitive intelligence including competing products, win/loss analysis, and displacement history. Use this to discover competitor IDs for other operations.

NameTypeRequiredDescription

pageNumberintegeroptionalPage number.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_list_folders#List all folders in ZoomInfo GTM Studio with optional filtering and sorting. Useful for browsing folder structure or finding a folderId before creating or moving audiences.10 params

List all folders in ZoomInfo GTM Studio with optional filtering and sorting. Useful for browsing folder structure or finding a folderId before creating or moving audiences.

NameTypeRequiredDescription

filter_createdAfterstringoptionalFilter folders created after this date (ISO 8601).

filter_createdBeforestringoptionalFilter folders created before this date (ISO 8601).

filter_searchTextstringoptionalFilter folders by partial name match.

filter_updatedAfterstringoptionalFilter folders updated after this date (ISO 8601).

filter_updatedBeforestringoptionalFilter folders updated before this date (ISO 8601).

pageNumberintegeroptionalPage number for pagination. Default is 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

schema_versionstringoptionalSchema version override

sortstringoptionalSort field. Valid values: name, createdAt, updatedAt, audienceCount, recentlyViewed. Prefix with - for descending. Default: -updatedAt.

tool_versionstringoptionalTool version override

zoominfo_list_marketing_audiences#List all ZoomInfo marketing audiences with optional pagination.4 params

List all ZoomInfo marketing audiences with optional pagination.

NameTypeRequiredDescription

pageSizeintegeroptionalNumber of audiences per page.

pageTokenstringoptionalPagination token from previous response.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_list_offerings#List all products and services configured for the authenticated ZoomInfo customer. Products serve as the central linking object across GTM config, connecting buyer personas, ICPs, and competitors. Use this to discover offering IDs for other operations.4 params

List all products and services configured for the authenticated ZoomInfo customer. Products serve as the central linking object across GTM config, connecting buyer personas, ICPs, and competitors. Use this to discover offering IDs for other operations.

NameTypeRequiredDescription

pageNumberintegeroptionalPage number.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_list_pulses#List the authenticated user's active intelligence pulses — lightweight signals optimized for LLM consumption. Each pulse includes a plain-text summary, priority (HIGH/MEDIUM/LOW), category, and company/contact references. Dismissed, saved, and expired pulses are excluded.4 params

List the authenticated user's active intelligence pulses — lightweight signals optimized for LLM consumption. Each pulse includes a plain-text summary, priority (HIGH/MEDIUM/LOW), category, and company/contact references. Dismissed, saved, and expired pulses are excluded.

NameTypeRequiredDescription

pageNumberintegeroptionalPage number for pagination.

pageSizeintegeroptionalResults per page (1-100).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_list_segments#List all Ideal Customer Profiles (ICPs) configured for the authenticated ZoomInfo customer. ICPs define target company profiles by firmographic attributes like industry, size, revenue, and geography. Use this to discover segment IDs for other operations.4 params

List all Ideal Customer Profiles (ICPs) configured for the authenticated ZoomInfo customer. ICPs define target company profiles by firmographic attributes like industry, size, revenue, and geography. Use this to discover segment IDs for other operations.

NameTypeRequiredDescription

pageNumberintegeroptionalPage number.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_lookup_data#Get valid values for ZoomInfo filter fields such as industries, departments, intent topics, scoop types, tech products, countries, and more. Use this to discover accepted values before calling search or enrich endpoints.7 params

Get valid values for ZoomInfo filter fields such as industries, departments, intent topics, scoop types, tech products, countries, and more. Use this to discover accepted values before calling search or enrich endpoints.

NameTypeRequiredDescription

fieldNamestringrequiredThe lookup field to retrieve valid values for.

filter_categorystringoptionalCategory filter (hashtags and tech lookups only).

filter_parentCategorystringoptionalParent category filter (hashtags and tech lookups only).

filter_subCategorystringoptionalSub-category filter (hashtags and tech lookups only).

filter_vendorstringoptionalVendor filter (hashtags and tech lookups only).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_lookup_enrich_fields#Get available input or output fields for ZoomInfo enrich endpoints by entity type. Use this to discover which fields you can pass as match criteria (input) or request in enriched results (output) for contacts, companies, scoops, news, intent, technologies, hashtags, org charts, and corporate hierarchy.4 params

Get available input or output fields for ZoomInfo enrich endpoints by entity type. Use this to discover which fields you can pass as match criteria (input) or request in enriched results (output) for contacts, companies, scoops, news, intent, technologies, hashtags, org charts, and corporate hierarchy.

NameTypeRequiredDescription

filter_entitystringrequiredEntity type to get enrich fields for.

filter_fieldTypestringrequiredField type — input fields for match criteria or output fields for response.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_lookup_search_fields#Get available input or output fields for ZoomInfo search endpoints by entity type. Use this to discover which fields you can filter by (input) or request in results (output) for contact, company, scoop, news, or intent searches.4 params

Get available input or output fields for ZoomInfo search endpoints by entity type. Use this to discover which fields you can filter by (input) or request in results (output) for contact, company, scoop, news, or intent searches.

NameTypeRequiredDescription

filter_entitystringrequiredEntity type to get search fields for.

filter_fieldTypestringrequiredField type to return — input fields for filtering or output fields for response.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_run_agent_team#Trigger an Agent Team run. Returns 202 with a run ID to poll via List Agent Team Runs or Get Agent Team Results. Any team can be run manually regardless of active/inactive status.4 params

Trigger an Agent Team run. Returns 202 with a run ID to poll via List Agent Team Runs or Get Agent Team Results. Any team can be run manually regardless of active/inactive status.

NameTypeRequiredDescription

agentTeamIdstringrequiredRequired. Unique identifier of the Agent Team to run.

inputsarrayoptionalOptional named input values for the run.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_search_companies#Search ZoomInfo's company database using name, industry, revenue, headcount, location, funding, and technology filters. Does not consume credits. Use Enrich Companies to get full firmographic details.35 params

Search ZoomInfo's company database using name, industry, revenue, headcount, location, funding, and technology filters. Does not consume credits. Use Enrich Companies to get full firmographic details.

NameTypeRequiredDescription

companyDescriptionstringoptionalKeywords to search in company descriptions.

companyIdstringoptionalZoomInfo unique identifier for a company.

companyNamestringoptionalFilter by company name.

companyRankingstringoptionalCompany ranking ID (e.g. Fortune 500). Comma-separated list of IDs.

companyTypestringoptionalFilter by company type. Accepts comma-separated list.

companyWebsitestringoptionalFilter by company website URL. Accepts comma-separated list.

continentstringoptionalContinent of the primary address.

countrystringoptionalCountry of the primary address.

employeeCountstringoptionalPre-defined employee count range. Accepts comma-separated values.

employeeRangeMaxstringoptionalMaximum employee count.

employeeRangeMinstringoptionalMinimum employee count.

excludeDefunctCompaniesbooleanoptionalSet to true to exclude defunct companies from results.

excludeTechAttributeTagListstringoptionalExclude companies with these tech tags. Comma-separated.

fundingAmountMaxintegeroptionalMaximum funding amount in thousands of USD.

fundingAmountMinintegeroptionalMinimum funding amount in thousands of USD.

fundingEndDatestringoptionalEnd date for funding range in YYYY-MM-DD format.

fundingStartDatestringoptionalStart date for funding range in YYYY-MM-DD format.

industryCodesstringoptionalComma-separated list of industry codes.

industryKeywordsstringoptionalIndustry keywords. Supports AND/OR operators.

metroRegionstringoptionalMetro area. Comma-separated list of US/Canada metro areas.

naicsCodesstringoptionalComma-separated list of NAICS codes.

oneYearEmployeeGrowthRateMaxstringoptionalMaximum 1-year employee growth rate percentage.

oneYearEmployeeGrowthRateMinstringoptionalMinimum 1-year employee growth rate percentage.

pageNumberintegeroptionalPage number for pagination, starting from 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

parentIdstringoptionalZoomInfo Company ID for the parent company.

revenueMaxintegeroptionalMaximum annual revenue in thousands of USD.

revenueMinintegeroptionalMinimum annual revenue in thousands of USD.

schema_versionstringoptionalSchema version override

sicCodesstringoptionalComma-separated list of SIC codes.

sortstringoptionalSort field. Valid values: name, employeeCount, revenue. Prefix with - for descending.

statestringoptionalState or province of the company's address.

techAttributeTagListstringoptionalTechnology product tag IDs. Comma-separated, supports AND logic.

tool_versionstringoptionalTool version override

zipCodestringoptionalZip or postal code.

zoominfo_search_contacts#Search ZoomInfo's contact database using name, title, company, location, industry, and other filters. Returns contact profiles with accuracy scores. Does not consume credits. Use Enrich Contacts to get emails and phone numbers.32 params

Search ZoomInfo's contact database using name, title, company, location, industry, and other filters. Returns contact profiles with accuracy scores. Does not consume credits. Use Enrich Contacts to get emails and phone numbers.

NameTypeRequiredDescription

companyIdstringoptionalZoomInfo company ID.

companyNamestringoptionalFilter by company name.

companyWebsitestringoptionalFilter by company website URL.

contactAccuracyScoreMinstringoptionalMinimum contact accuracy score (70-99).

countrystringoptionalCountry of the company's primary address.

departmentstringoptionalFilter by department. Accepts comma-separated list.

emailAddressstringoptionalFilter by email address.

employeeRangeMaxstringoptionalMaximum employee count.

employeeRangeMinstringoptionalMinimum employee count.

exactJobTitlestringoptionalFilter by exact job title match.

excludeJobTitlestringoptionalComma-separated list of job titles to exclude.

executivesOnlybooleanoptionalSet to true to return only executive-level contacts.

firstNamestringoptionalFilter by contact's first name.

fullNamestringoptionalFilter by contact's full name.

industryCodesstringoptionalComma-separated list of industry codes. Use lookup/data to get valid values.

jobTitlestringoptionalFilter by job title. Use OR to combine multiple titles.

lastNamestringoptionalFilter by contact's last name.

lastUpdatedDateAfterstringoptionalReturn only contacts updated after this date (YYYY-MM-DD).

managementLevelstringoptionalFilter by management level.

naicsCodesstringoptionalComma-separated list of NAICS codes.

pageNumberintegeroptionalPage number for pagination, starting from 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

personIdstringoptionalZoomInfo unique identifier for the contact.

requiredFieldsstringoptionalRequired data fields. Accepted values: email, phone, directPhone, personalEmail, mobilePhone.

revenueMaxintegeroptionalMaximum annual revenue in thousands of USD.

revenueMinintegeroptionalMinimum annual revenue in thousands of USD.

schema_versionstringoptionalSchema version override

sicCodesstringoptionalComma-separated list of SIC codes.

sortstringoptionalSort field. Valid values: contactAccuracyScore, lastName, companyName, hierarchy, sourceCount, lastMentioned, relevance. Prefix with - for descending.

statestringoptionalState or province of the company's address.

tool_versionstringoptionalTool version override

validDateAfterstringoptionalReturn only contacts with a valid date after this date (YYYY-MM-DD).

zoominfo_search_intent#Search ZoomInfo buying intent signals by topic and company filters. Topics are required (up to 50). Returns companies showing intent with signal score and audience strength. Counts as record credits.22 params

Search ZoomInfo buying intent signals by topic and company filters. Topics are required (up to 50). Returns companies showing intent with signal score and audience strength. Counts as record credits.

NameTypeRequiredDescription

topicsarrayrequiredRequired. Array of up to 50 intent topic names. Use lookup/data to get valid topic values.

audienceStrengthMaxstringoptionalMaximum audience strength (A-E, where A = largest audience).

audienceStrengthMinstringoptionalMinimum audience strength (A-E, where A = largest audience).

companyIdstringoptionalFilter by ZoomInfo company ID.

companyNamestringoptionalFilter by company name.

countrystringoptionalFilter by country.

employeeRangeMaxstringoptionalMaximum employee count.

employeeRangeMinstringoptionalMinimum employee count.

findRecommendedContactsbooleanoptionalSet to false to exclude recommended contacts from results. Default is true.

industryCodesstringoptionalComma-separated list of industry codes.

pageNumberintegeroptionalPage number for pagination, starting from 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

revenueMaxintegeroptionalMaximum annual revenue in thousands of USD.

revenueMinintegeroptionalMinimum annual revenue in thousands of USD.

schema_versionstringoptionalSchema version override

signalEndDatestringoptionalEnd date for intent signals in YYYY-MM-DD format.

signalScoreMaxintegeroptionalMaximum signal score (60-100).

signalScoreMinintegeroptionalMinimum signal score (60-100).

signalStartDatestringoptionalStart date for intent signals in YYYY-MM-DD format.

sortstringoptionalSort field. Valid values: signalDate, companyName, signalScore, category, topic, audienceStrength. Prefix with - for descending.

statestringoptionalFilter by state or province.

tool_versionstringoptionalTool version override

zoominfo_search_news#Search ZoomInfo news articles by category, URL, and date range. Returns news articles across all ZoomInfo companies. At least one filter must be provided. Does not consume credits but counts toward record and request limits. Use Enrich News to get articles for a specific company.8 params

Search ZoomInfo news articles by category, URL, and date range. Returns news articles across all ZoomInfo companies. At least one filter must be provided. Does not consume credits but counts toward record and request limits. Use Enrich News to get articles for a specific company.

NameTypeRequiredDescription

categoriesarrayoptionalCategory of news articles to filter by.

pageDateMaxstringoptionalLatest publishing date for news articles.

pageDateMinstringoptionalEarliest publishing date for news articles.

pageNumberintegeroptionalPage number for pagination.

pageSizeintegeroptionalResults per page.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

urlarrayoptionalNews article URLs to search for.

zoominfo_search_scoops#Search ZoomInfo scoops — real-time business intelligence signals about leadership changes, funding, partnerships, and strategic events. Filter by scoop type, topic, department, date range, contact, and company criteria. Does not consume credits but counts toward record and request limits.35 params

Search ZoomInfo scoops — real-time business intelligence signals about leadership changes, funding, partnerships, and strategic events. Filter by scoop type, topic, department, date range, contact, and company criteria. Does not consume credits but counts toward record and request limits.

NameTypeRequiredDescription

companyIdstringoptionalZoomInfo company ID.

companyNamestringoptionalFilter by company name.

contactAccuracyScoreMinstringoptionalMinimum contact accuracy score (70-99).

countrystringoptionalCountry of the company's primary address.

departmentstringoptionalDepartment associated with the scoop. See Scoop Departments lookup for valid values.

descriptionstringoptionalKeywords to search in scoop descriptions. Space-separated list of words.

employeeRangeMaxstringoptionalMaximum employee count.

employeeRangeMinstringoptionalMinimum employee count.

executivesOnlybooleanoptionalSet to true to return only executive-level contacts. Default is false.

firstNamestringoptionalFilter by contact's first name mentioned in scoop.

fundingAmountMaxintegeroptionalMaximum funding amount in thousands of USD.

fundingAmountMinintegeroptionalMinimum funding amount in thousands of USD.

fundingEndDatestringoptionalEnd date for funding range in YYYY-MM-DD format.

fundingStartDatestringoptionalStart date for funding range in YYYY-MM-DD format.

industryCodesstringoptionalComma-separated list of industry codes.

jobTitlestringoptionalFilter by contact's job title.

lastNamestringoptionalFilter by contact's last name mentioned in scoop.

managementLevelstringoptionalFilter by contact's management level.

metroRegionstringoptionalMetro area. Comma-separated list of US/Canada metro areas.

naicsCodesstringoptionalComma-separated list of NAICS codes.

pageNumberintegeroptionalPage number for pagination, starting from 1.

pageSizeintegeroptionalResults per page. Valid values: 1-100. Default is 25.

publishedEndDatestringoptionalEnd date for scoop publication date range in YYYY-MM-DD format.

publishedStartDatestringoptionalStart date for scoop publication date range in YYYY-MM-DD format.

revenueMaxintegeroptionalMaximum annual revenue in thousands of USD.

revenueMinintegeroptionalMinimum annual revenue in thousands of USD.

schema_versionstringoptionalSchema version override

scoopIdstringoptionalZoomInfo unique scoop ID. Accepts comma-separated list.

scoopTopicstringoptionalScoop topic IDs. Comma-separated list from the lookup endpoint (e.g. integration, consolidation, compliance).

scoopTypestringoptionalScoop type IDs. Comma-separated list from the lookup endpoint (e.g. earnings, awards, partnerships).

sicCodesstringoptionalComma-separated list of SIC codes.

sortstringoptionalSort field. Valid values: scoopId, originalPublishedDate, description, link, linkText. Prefix with - for descending.

statestringoptionalState or province of the company's address.

tool_versionstringoptionalTool version override

updatedSinceCreationbooleanoptionalSet to true to only return scoops updated since publishedStartDate. Default is false.

zoominfo_unarchive_buyer_persona#Restore a previously archived buyer persona to active status, making it available again for use in GTM workflows.3 params

Restore a previously archived buyer persona to active status, making it available again for use in GTM workflows.

NameTypeRequiredDescription

buyerPersonaIdstringrequiredUUID of the buyer persona.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_unarchive_competitor#Restore a previously archived competitor record to active status.3 params

Restore a previously archived competitor record to active status.

NameTypeRequiredDescription

competitorIdstringrequiredUUID of the competitor.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_unarchive_offering#Restore a previously archived product or service to active status.3 params

Restore a previously archived product or service to active status.

NameTypeRequiredDescription

offeringIdstringrequiredUUID of the product or service.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_unarchive_segment#Restore a previously archived ICP to active status.3 params

Restore a previously archived ICP to active status.

NameTypeRequiredDescription

segmentIdstringrequiredUUID of the ICP segment.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_update_audience#Update an audience's name, folder, description, or notes. Only provided fields are modified (partial update). Use this to rename an audience or move it to a different folder.7 params

Update an audience's name, folder, description, or notes. Only provided fields are modified (partial update). Use this to rename an audience or move it to a different folder.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience to update.

descriptionstringoptionalUpdated description.

folderIdstringoptionalUUID of the folder to move the audience to.

namestringoptionalNew display name.

notesstringoptionalUpdated notes.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_update_audience_column#Update a column's name, frozen state, or visibility within an audience. Only provided fields are modified. Cannot update columns with isEditable=false.7 params

Update a column's name, frozen state, or visibility within an audience. Only provided fields are modified. Cannot update columns with isEditable=false.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

columnIdstringrequiredUUID of the column to update.

isFrozenbooleanoptionalWhether the column is pinned to the left in grid views.

isHiddenbooleanoptionalWhether the column is hidden from grid views.

namestringoptionalNew display name for the column.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_update_folder#Update a folder's name, description, notes, or starred status. Only provided fields are modified (partial update).7 params

Update a folder's name, description, notes, or starred status. Only provided fields are modified (partial update).

NameTypeRequiredDescription

folderIdstringrequiredUUID of the folder to update.

descriptionstringoptionalUpdated description.

namestringoptionalNew display name for the folder.

notesstringoptionalUpdated notes.

schema_versionstringoptionalSchema version override

starredbooleanoptionalWhether the folder is starred.

tool_versionstringoptionalSchema version override

zoominfo_update_marketing_audience#Update the name of an existing ZoomInfo marketing audience.4 params

Update the name of an existing ZoomInfo marketing audience.

NameTypeRequiredDescription

audienceIdstringrequiredID of the audience to update.

namestringrequiredNew name for the audience.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_upload_marketing_audience#Add or remove records from a ZoomInfo marketing audience. Define the schema using fields (column names) and provide records as arrays matching the field order. Returns 201 with the upload job.6 params

Add or remove records from a ZoomInfo marketing audience. Define the schema using fields (column names) and provide records as arrays matching the field order. Returns 201 with the upload job.

NameTypeRequiredDescription

audienceIdstringrequiredID of the marketing audience.

fieldsarrayrequiredSchema defining which fields are in each record.

operationTypestringrequiredType of upload operation.

recordsarrayrequiredList of records to upload, each matching the field schema order.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_upsert_audience_match_criteria#Set or update column match criteria for an audience, mapping audience columns to ZoomInfo attributes (e.g. an 'Email' column to CONTACT_EMAIL). If matchCriteria is omitted, the system uses AI to auto-map columns. Replaces existing match criteria.4 params

Set or update column match criteria for an audience, mapping audience columns to ZoomInfo attributes (e.g. an 'Email' column to CONTACT_EMAIL). If matchCriteria is omitted, the system uses AI to auto-map columns. Replaces existing match criteria.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

matchCriteriaarrayoptionalArray of column-to-ZoomInfo-attribute mappings.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_upsert_audience_rows#Create and/or update up to 500 rows in an audience in one operation. Include id (rowId) to update; omit it to create. Optionally trigger enrichment on affected rows after upsert by setting runEnrichment=true.6 params

Create and/or update up to 500 rows in an audience in one operation. Include id (rowId) to update; omit it to create. Optionally trigger enrichment on affected rows after upsert by setting runEnrichment=true.

NameTypeRequiredDescription

audienceIdstringrequiredUUID of the audience.

rowsarrayrequiredArray of row objects to create or update (max 500).

columnsarrayoptionalColumn IDs to enrich (only used when runEnrichment=true).

runEnrichmentbooleanoptionalWhether to run enrichment after upsert.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalSchema version override

zoominfo_upsert_buyer_persona#Create a new buyer persona or update an existing one. Include id to update; omit it to create. Only name is required for creation. Buyer personas capture buyer role, objectives, priorities, and engagement insights for GTM alignment.10 params

Create a new buyer persona or update an existing one. Include id to update; omit it to create. Only name is required for creation. Buyer personas capture buyer role, objectives, priorities, and engagement insights for GTM alignment.

NameTypeRequiredDescription

customFieldsarrayoptionalCustom key-value fields for extended persona metadata.

descriptionstringoptionalDetailed description of the persona's role and relevance to the sales process. Max 10,000 chars.

idstringoptionalPersona ID to update. Omit to create a new persona.

namestringoptionalName of the buyer persona (required for creation, 1-1024 chars).

personalObjectivesstringoptionalPersonal objectives, KPIs, and success metrics that drive this persona's purchasing decisions. Max 10,000 chars.

relevantOfferingsstringoptionalOfferings from your portfolio that this persona would be interested in. Max 10,000 chars.

schema_versionstringoptionalSchema version override

titlesFunctionsSenioritystringoptionalTypical job titles, functional areas, and seniority levels for this persona. Max 10,000 chars.

tool_versionstringoptionalTool version override

whatDoesThisPersonaCareAboutstringoptionalMessaging angle — what this persona cares about in your offering. Max 10,000 chars.

zoominfo_upsert_competitor#Create a new competitor record or update an existing one. Include id to update; omit it to create. Only name is required for creation. Captures competitive intelligence including win/loss analysis, competing products, and displacement scenarios.12 params

Create a new competitor record or update an existing one. Include id to update; omit it to create. Only name is required for creation. Captures competitive intelligence including win/loss analysis, competing products, and displacement scenarios.

NameTypeRequiredDescription

competitiveProductsstringoptionalYour own products that directly compete with this competitor. Max 10,000 chars.

competitorProductsstringoptionalCompetitor products that overlap with your portfolio. Max 10,000 chars.

customersWeWonstringoptionalAccounts won from this competitor. Useful for competitive proof points. Max 10,000 chars.

customFieldsarrayoptionalCustom key-value fields for extended competitor intelligence.

descriptionstringoptionalDetailed description of the competitor including market position and strengths. Max 10,000 chars.

idstringoptionalCompetitor ID to update. Omit to create a new competitor.

namestringoptionalName of the competitor company (required for creation, 1-1024 chars).

reasonsTheyLosestringoptionalWhy this competitor loses deals — weaknesses and gaps where you hold an advantage. Max 10,000 chars.

reasonsTheyWinstringoptionalWhy this competitor wins deals — key strengths and differentiators. Max 10,000 chars.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

urlstringoptionalCompetitor's website URL. Max 1,024 chars.

zoominfo_upsert_content_interactions#Create or update a content interaction engagement record (website visit, email click, form submission, etc.). Records participant details, interaction type, channel, and content type.22 params

Create or update a content interaction engagement record (website visit, email click, form submission, etc.). Records participant details, interaction type, channel, and content type.

NameTypeRequiredDescription

actionPerformedAtstringrequiredRequired. Timestamp when the interaction started (ISO 8601).

channelstringrequiredRequired. Source or medium of the interaction.

companyDomainstringrequiredRequired. Company domain of the participant.

contentTypestringrequiredRequired. Category or format of the content.

engagementIdstringrequiredRequired. Unique content interaction identifier.

instanceIdstringrequiredRequired. Unique identifier of the customer's organization in the external platform.

interactionTypestringrequiredRequired. Specific action performed.

statusstringrequiredRequired. Interaction status.

companyNamestringoptionalParticipant company name.

durationintegeroptionalLength of interaction in seconds.

emailstringoptionalParticipant email address.

endedAtstringoptionalTimestamp when the interaction ended (ISO 8601).

firstNamestringoptionalParticipant first name.

instanceUrlstringoptionalURL of the customer's organization in the external platform.

interactionDetailsobjectoptionalAdditional interaction attributes as key-value pairs.

lastNamestringoptionalParticipant last name.

phoneNumberstringoptionalParticipant phone number.

schema_versionstringoptionalSchema version override

targetNamestringoptionalTarget name.

targetUrlstringoptionalTarget URL of the interaction.

titlestringoptionalParticipant job title.

tool_versionstringoptionalSchema version override

zoominfo_upsert_offering#Create a new product/service or update an existing one. Include id to update; omit it to create. Only name is required for creation. Products serve as the central linking object connecting buyer personas, ICPs, and competitors in your GTM config.13 params

Create a new product/service or update an existing one. Include id to update; omit it to create. Only name is required for creation. Products serve as the central linking object connecting buyer personas, ICPs, and competitors in your GTM config.

NameTypeRequiredDescription

competitorsstringoptionalText description of competitors relevant to this product. Max 10,000 chars.

customFieldsarrayoptionalCustom key-value fields for extended product metadata.

descriptionstringoptionalDetailed description including purpose, target audience, and key benefits. Max 10,000 chars.

idstringoptionalProduct/service ID to update. Omit to create a new record.

idealCompanySegmentstringoptionalText description of the ideal company segment for this product. Max 10,000 chars.

namestringoptionalName of the product or service (required for creation, 1-1024 chars).

offeringBuyerPersonasstringoptionalText description of the buyer personas relevant to this product. Max 10,000 chars.

painPointsarrayoptionalCustomer pain points this product addresses. Array of strings, max 100 items.

proofPointsarrayoptionalReviews, testimonials, or case-study references validating effectiveness. Array of strings, max 100 items.

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

urlstringoptionalURL of the product or service webpage. Max 1,024 chars.

valuePropositionarrayoptionalKey reasons a buyer should choose this product. Array of strings, max 100 items.

zoominfo_upsert_segment#Create a new Ideal Customer Profile (ICP) or update an existing one. Include id to update; omit it to create. Only name is required for creation. ICPs define target company profiles using firmographic criteria like industry, size, revenue, and geography.6 params

Create a new Ideal Customer Profile (ICP) or update an existing one. Include id to update; omit it to create. Only name is required for creation. ICPs define target company profiles using firmographic criteria like industry, size, revenue, and geography.

NameTypeRequiredDescription

customFieldsarrayoptionalCustom key-value fields for extended ICP criteria.

descriptionstringoptionalDescription of the ICP including industry, company size, revenue range, and geography. Max 10,000 chars.

idstringoptionalICP segment ID to update. Omit to create a new ICP.

namestringoptionalName of the ICP (required for creation, 1-1024 chars).

schema_versionstringoptionalSchema version override

tool_versionstringoptionalTool version override

zoominfo_upsert_settings#Create or update the customer settings singleton for the authenticated ZoomInfo account. Settings include company name, elevator pitch, description, and strategic priorities used by AI recommendations. At least one attribute must be provided. Updates are partial — only provided fields are modified.7 params

Create or update the customer settings singleton for the authenticated ZoomInfo account. Settings include company name, elevator pitch, description, and strategic priorities used by AI recommendations. At least one attribute must be provided. Updates are partial — only provided fields are modified.

NameTypeRequiredDescription

customFieldsarrayoptionalCustom key-value fields for extended settings.

descriptionstringoptionalCompany description including market position and target audience (max 10,000 chars).

elevatorPitchstringoptionalBrief elevator pitch or value proposition. Used by AI agents to understand your core offering (max 1,024 chars).

namestringoptionalEditable display name for the customer organization (max 1,024 chars).

schema_versionstringoptionalSchema version override

strategicPrioritiesstringoptionalKey business objectives, growth targets, and focus areas used by AI to align GTM recommendations (max 10,000 chars).

tool_versionstringoptionalTool version override

ZoomInfo connector

ZoomInfo connector

Install the SDK

Set your credentials

Set up the connector

Create a ZoomInfo API app

Configure OAuth settings

Create a connection in Scalekit

Authorize and make your first call

What you can do

Tool list