ZoomInfo connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. 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>

3. 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).

4. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'zoominfo'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize ZoomInfo:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'zoominfo_get_company_lookalikes',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "zoominfo"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize ZoomInfo:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="zoominfo_get_company_lookalikes",
       connection_name=connection_name,
       identifier=identifier,
   )
   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.

Name Type Required Description

buyerPersonaId string required UUID of the buyer persona.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

competitorId string required UUID of the competitor.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

offeringId string required UUID of the product or service.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

segmentId string required UUID of the ICP segment.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

companyId integer required ZoomInfo unique company ID.

question string required The question to ask about the company's account data.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

name string required Required. Display name of the audience.

type string required Record type the audience holds (CONTACT or COMPANY).

autoMatchCriteria boolean optional Enable AI auto-mapping of column match criteria.

columns array optional Column definitions to add to the audience at creation.

description string optional Optional description of the audience's purpose.

folderId string optional UUID of the folder to place this audience in. If omitted, a new folder matching the audience name is created automatically.

notes string optional Optional internal notes about the audience.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

audienceId string required UUID of the audience to add columns to.

columns array required Array of column definitions to create.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

name string required Display name of the folder.

description string optional Optional description of the folder's purpose.

notes string optional Optional internal notes about the folder.

schema_version string optional Schema version override

starred boolean optional Whether the folder is starred for quick access.

tool_version string optional Tool 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.

Name Type Required Description

audienceType string required Audience type — B2B or B2C.

name string required Name of the audience.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience to delete.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

columnId string required UUID of the column to delete.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

rowIds array required Array of row IDs to permanently delete (max 1000).

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

buyerPersonaId string required UUID of the buyer persona to permanently delete.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

competitorId string required UUID of the competitor to delete.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

id string required Required. Unique identifier of the content interaction to delete.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

folderId string required UUID of the folder to delete.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required ID of the audience to delete.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

offeringId string required UUID of the product or service.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

segmentId string required UUID of the ICP segment.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

audienceId string required UUID of the audience to enrich.

scope string required Enrichment scope.

columns array optional Column IDs to enrich (optional for any scope).

rows array optional Row IDs to enrich (required when scope=ROW).

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

matchCompanyInput array required List of up to 25 companies to match and enrich.

outputFields array required Fields to include in the response for each enriched company.

requiredFields array optional Fields that must be present in the result for a record to be returned.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

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

outputFields array required Fields to include in the response for each enriched contact.

requiredFields array optional Fields that must be present in the result for a record to be returned.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

matchCompanyInput array required List of up to 25 companies to match and retrieve hierarchy for.

outputFields array required Fields to include in the response for each enriched company hierarchy.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

companyId integer required ZoomInfo unique company ID.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

topics array required Array of up to 50 intent topic names to fetch signals for.

audienceStrengthMax string optional Maximum audience strength (A-E, where A = largest audience).

audienceStrengthMin string optional Minimum audience strength (A-E, where A = largest audience).

companyId integer optional ZoomInfo unique company ID. Provide at least one of companyId, companyName, or companyWebsite.

companyName string optional Company name. Provide at least one of companyId, companyName, or companyWebsite.

companyWebsite string optional Company website URL. Provide at least one of companyId, companyName, or companyWebsite.

findRecommendedContacts boolean optional Set to false to exclude recommended contacts from results. Default is true.

pageNumber integer optional Page number for pagination, starting from 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

schema_version string optional Schema version override

signalEndDate string optional End date for intent signals in YYYY-MM-DD format.

signalScoreMax integer optional Maximum signal score (60-100).

signalScoreMin integer optional Minimum signal score (60-100).

signalStartDate string optional Start date for intent signals in YYYY-MM-DD format.

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

tool_version string optional Tool 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.

Name Type Required Description

categories array optional News article categories to filter by.

companyId integer optional ZoomInfo unique company ID.

companyName string optional Company name.

companyWebsite string optional Company website URL.

pageDateMax string optional Latest publishing date for news articles.

pageDateMin string optional Earliest publishing date for news articles.

pageNumber integer optional Page number for pagination.

pageSize integer optional Results per page.

schema_version string optional Schema version override

tool_version string optional Tool version override

url array optional News 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.

Name Type Required Description

companyId string required ZoomInfo company ID to get org chart for.

department string required Comma-separated department IDs to get org chart data for.

contactAccuracyScoreMax string optional Maximum contact accuracy score (70-99).

contactAccuracyScoreMin string optional Minimum contact accuracy score (70-99).

pageNumber integer optional Page number for pagination.

pageSize integer optional Results per page.

schema_version string optional Schema version override

sort string optional Sort field.

tool_version string optional Tool 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.

Name Type Required Description

companyId string optional ZoomInfo company ID.

companyName string optional Company name.

companyWebsite string optional Company website URL.

department string optional Department associated with the scoop.

description string optional Keywords to search in scoop descriptions.

pageNumber integer optional Page number.

pageSize integer optional Results per page.

publishedEndDate string optional End date for scoop publication range.

publishedStartDate string optional Start date for scoop publication range.

schema_version string optional Schema version override

scoopId string optional ZoomInfo scoop ID.

scoopTopic string optional Scoop topic IDs.

scoopType string optional Scoop type IDs.

sort string optional Sort field.

tool_version string optional Tool version override

updatedSinceCreation boolean optional Return 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.

Name Type Required Description

companyId integer required ZoomInfo unique company ID.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

companyId integer required ZoomInfo unique company ID.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

agentTeamId string required Required. Unique identifier of the Agent Team.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

agentTeamId string required Required. Unique identifier of the Agent Team.

runId string required Required. Unique identifier of the run returned by Run Agent Team.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience to get filter metadata for.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience the job belongs to.

jobId string required UUID of the async job to check.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

rowId string required UUID of the row to retrieve.

columns array optional Column IDs to include in the response.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

buyerPersonaId string required UUID of the buyer persona to retrieve.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

audienceId string required UUID of the audience.

tool string required AI tool type to get data dependencies for.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

filter_companyId string optional ZoomInfo unique company ID to use as the reference for finding lookalikes.

filter_companyName string optional Name of the reference company to find lookalikes for.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

competitorId string required UUID of the competitor.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

filter_referencePersonId integer required ZoomInfo person ID of the reference contact to find lookalikes for.

filter_targetCompanyId integer optional Constrain lookalike search to a specific target company.

page_size integer optional Number of lookalike contacts to return (1-100).

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

filter_useCaseType string required Sales motion type to drive recommendations.

filter_ziCompanyId integer required ZoomInfo company ID of the target account to get contact recommendations for.

page_size integer optional Number of recommendations to return (1-100).

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

id string required Required. Unique identifier of the content interaction engagement.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

folderId string required UUID of the folder.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

ziCompanyIds array required List of ZoomInfo company IDs to retrieve insights for (max 50).

schema_version string optional Schema version override

signalTypes array optional Optional filter for specific insight/signal types. Returns all types if omitted.

tool_version string optional Tool 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.

Name Type Required Description

audienceId string required ID of the marketing audience.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required ID of the marketing audience.

uploadId string required ID of the upload job.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

offeringId string required UUID of the product or service.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

segmentId string required UUID of the ICP segment.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

agentTeamId string required Required. Unique identifier of the Agent Team.

pageNumber integer optional Page number for pagination. Default is 1.

pageSize integer optional Results per page (1-100). Default is 25.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

filter_name string optional Filter agent teams by name.

pageNumber integer optional Page number for pagination. Default is 1.

pageSize integer optional Results per page (1-100). Default is 25.

schema_version string optional Schema version override

sort string optional Sort field. Valid values: name, createdAt, updatedAt. Prefix with - for descending.

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

columns array optional Column IDs to include in response.

filter object optional Filter group with logical operator and filter conditions.

ids array optional Specific row IDs to retrieve.

pageNumber integer optional Page number.

pageSize integer optional Results per page.

schema_version string optional Schema version override

sort string optional Column ID to sort by.

tool_version string optional Schema 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.

Name Type Required Description

filter_searchText string optional Filter audiences by name using a case-insensitive contains match.

filter_type string optional Filter by audience record type.

pageNumber integer optional Page number for pagination. Default is 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

schema_version string optional Schema version override

sort string optional Sort field. Valid values: name, createdAt, updatedAt, recordCount. Prefix with - for descending. Default: -updatedAt.

tool_version string optional Tool 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.

Name Type Required Description

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

pageNumber integer optional Page number.

pageSize integer optional Results per page.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

filter_createdAfter string optional Filter folders created after this date (ISO 8601).

filter_createdBefore string optional Filter folders created before this date (ISO 8601).

filter_searchText string optional Filter folders by partial name match.

filter_updatedAfter string optional Filter folders updated after this date (ISO 8601).

filter_updatedBefore string optional Filter folders updated before this date (ISO 8601).

pageNumber integer optional Page number for pagination. Default is 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

schema_version string optional Schema version override

sort string optional Sort field. Valid values: name, createdAt, updatedAt, audienceCount, recentlyViewed. Prefix with - for descending. Default: -updatedAt.

tool_version string optional Tool version override

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

List all ZoomInfo marketing audiences with optional pagination.

Name Type Required Description

pageSize integer optional Number of audiences per page.

pageToken string optional Pagination token from previous response.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

pageNumber integer optional Page number.

pageSize integer optional Results per page.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

pageNumber integer optional Page number for pagination.

pageSize integer optional Results per page (1-100).

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

pageNumber integer optional Page number.

pageSize integer optional Results per page.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

fieldName string required The lookup field to retrieve valid values for.

filter_category string optional Category filter (hashtags and tech lookups only).

filter_parentCategory string optional Parent category filter (hashtags and tech lookups only).

filter_subCategory string optional Sub-category filter (hashtags and tech lookups only).

filter_vendor string optional Vendor filter (hashtags and tech lookups only).

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

filter_entity string required Entity type to get enrich fields for.

filter_fieldType string required Field type — input fields for match criteria or output fields for response.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

filter_entity string required Entity type to get search fields for.

filter_fieldType string required Field type to return — input fields for filtering or output fields for response.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

agentTeamId string required Required. Unique identifier of the Agent Team to run.

inputs array optional Optional named input values for the run.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

companyDescription string optional Keywords to search in company descriptions.

companyId string optional ZoomInfo unique identifier for a company.

companyName string optional Filter by company name.

companyRanking string optional Company ranking ID (e.g. Fortune 500). Comma-separated list of IDs.

companyType string optional Filter by company type. Accepts comma-separated list.

companyWebsite string optional Filter by company website URL. Accepts comma-separated list.

continent string optional Continent of the primary address.

country string optional Country of the primary address.

employeeCount string optional Pre-defined employee count range. Accepts comma-separated values.

employeeRangeMax string optional Maximum employee count.

employeeRangeMin string optional Minimum employee count.

excludeDefunctCompanies boolean optional Set to true to exclude defunct companies from results.

excludeTechAttributeTagList string optional Exclude companies with these tech tags. Comma-separated.

fundingAmountMax integer optional Maximum funding amount in thousands of USD.

fundingAmountMin integer optional Minimum funding amount in thousands of USD.

fundingEndDate string optional End date for funding range in YYYY-MM-DD format.

fundingStartDate string optional Start date for funding range in YYYY-MM-DD format.

industryCodes string optional Comma-separated list of industry codes.

industryKeywords string optional Industry keywords. Supports AND/OR operators.

metroRegion string optional Metro area. Comma-separated list of US/Canada metro areas.

naicsCodes string optional Comma-separated list of NAICS codes.

oneYearEmployeeGrowthRateMax string optional Maximum 1-year employee growth rate percentage.

oneYearEmployeeGrowthRateMin string optional Minimum 1-year employee growth rate percentage.

pageNumber integer optional Page number for pagination, starting from 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

parentId string optional ZoomInfo Company ID for the parent company.

revenueMax integer optional Maximum annual revenue in thousands of USD.

revenueMin integer optional Minimum annual revenue in thousands of USD.

schema_version string optional Schema version override

sicCodes string optional Comma-separated list of SIC codes.

sort string optional Sort field. Valid values: name, employeeCount, revenue. Prefix with - for descending.

state string optional State or province of the company's address.

techAttributeTagList string optional Technology product tag IDs. Comma-separated, supports AND logic.

tool_version string optional Tool version override

zipCode string optional Zip 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.

Name Type Required Description

companyId string optional ZoomInfo company ID.

companyName string optional Filter by company name.

companyWebsite string optional Filter by company website URL.

contactAccuracyScoreMin string optional Minimum contact accuracy score (70-99).

country string optional Country of the company's primary address.

department string optional Filter by department. Accepts comma-separated list.

emailAddress string optional Filter by email address.

employeeRangeMax string optional Maximum employee count.

employeeRangeMin string optional Minimum employee count.

exactJobTitle string optional Filter by exact job title match.

excludeJobTitle string optional Comma-separated list of job titles to exclude.

executivesOnly boolean optional Set to true to return only executive-level contacts.

firstName string optional Filter by contact's first name.

fullName string optional Filter by contact's full name.

industryCodes string optional Comma-separated list of industry codes. Use lookup/data to get valid values.

jobTitle string optional Filter by job title. Use OR to combine multiple titles.

lastName string optional Filter by contact's last name.

lastUpdatedDateAfter string optional Return only contacts updated after this date (YYYY-MM-DD).

managementLevel string optional Filter by management level.

naicsCodes string optional Comma-separated list of NAICS codes.

pageNumber integer optional Page number for pagination, starting from 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

personId string optional ZoomInfo unique identifier for the contact.

requiredFields string optional Required data fields. Accepted values: email, phone, directPhone, personalEmail, mobilePhone.

revenueMax integer optional Maximum annual revenue in thousands of USD.

revenueMin integer optional Minimum annual revenue in thousands of USD.

schema_version string optional Schema version override

sicCodes string optional Comma-separated list of SIC codes.

sort string optional Sort field. Valid values: contactAccuracyScore, lastName, companyName, hierarchy, sourceCount, lastMentioned, relevance. Prefix with - for descending.

state string optional State or province of the company's address.

tool_version string optional Tool version override

validDateAfter string optional Return 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.

Name Type Required Description

topics array required Required. Array of up to 50 intent topic names. Use lookup/data to get valid topic values.

audienceStrengthMax string optional Maximum audience strength (A-E, where A = largest audience).

audienceStrengthMin string optional Minimum audience strength (A-E, where A = largest audience).

companyId string optional Filter by ZoomInfo company ID.

companyName string optional Filter by company name.

country string optional Filter by country.

employeeRangeMax string optional Maximum employee count.

employeeRangeMin string optional Minimum employee count.

findRecommendedContacts boolean optional Set to false to exclude recommended contacts from results. Default is true.

industryCodes string optional Comma-separated list of industry codes.

pageNumber integer optional Page number for pagination, starting from 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

revenueMax integer optional Maximum annual revenue in thousands of USD.

revenueMin integer optional Minimum annual revenue in thousands of USD.

schema_version string optional Schema version override

signalEndDate string optional End date for intent signals in YYYY-MM-DD format.

signalScoreMax integer optional Maximum signal score (60-100).

signalScoreMin integer optional Minimum signal score (60-100).

signalStartDate string optional Start date for intent signals in YYYY-MM-DD format.

sort string optional Sort field. Valid values: signalDate, companyName, signalScore, category, topic, audienceStrength. Prefix with - for descending.

state string optional Filter by state or province.

tool_version string optional Tool 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.

Name Type Required Description

categories array optional Category of news articles to filter by.

pageDateMax string optional Latest publishing date for news articles.

pageDateMin string optional Earliest publishing date for news articles.

pageNumber integer optional Page number for pagination.

pageSize integer optional Results per page.

schema_version string optional Schema version override

tool_version string optional Tool version override

url array optional News 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.

Name Type Required Description

companyId string optional ZoomInfo company ID.

companyName string optional Filter by company name.

contactAccuracyScoreMin string optional Minimum contact accuracy score (70-99).

country string optional Country of the company's primary address.

department string optional Department associated with the scoop. See Scoop Departments lookup for valid values.

description string optional Keywords to search in scoop descriptions. Space-separated list of words.

employeeRangeMax string optional Maximum employee count.

employeeRangeMin string optional Minimum employee count.

executivesOnly boolean optional Set to true to return only executive-level contacts. Default is false.

firstName string optional Filter by contact's first name mentioned in scoop.

fundingAmountMax integer optional Maximum funding amount in thousands of USD.

fundingAmountMin integer optional Minimum funding amount in thousands of USD.

fundingEndDate string optional End date for funding range in YYYY-MM-DD format.

fundingStartDate string optional Start date for funding range in YYYY-MM-DD format.

industryCodes string optional Comma-separated list of industry codes.

jobTitle string optional Filter by contact's job title.

lastName string optional Filter by contact's last name mentioned in scoop.

managementLevel string optional Filter by contact's management level.

metroRegion string optional Metro area. Comma-separated list of US/Canada metro areas.

naicsCodes string optional Comma-separated list of NAICS codes.

pageNumber integer optional Page number for pagination, starting from 1.

pageSize integer optional Results per page. Valid values: 1-100. Default is 25.

publishedEndDate string optional End date for scoop publication date range in YYYY-MM-DD format.

publishedStartDate string optional Start date for scoop publication date range in YYYY-MM-DD format.

revenueMax integer optional Maximum annual revenue in thousands of USD.

revenueMin integer optional Minimum annual revenue in thousands of USD.

schema_version string optional Schema version override

scoopId string optional ZoomInfo unique scoop ID. Accepts comma-separated list.

scoopTopic string optional Scoop topic IDs. Comma-separated list from the lookup endpoint (e.g. integration, consolidation, compliance).

scoopType string optional Scoop type IDs. Comma-separated list from the lookup endpoint (e.g. earnings, awards, partnerships).

sicCodes string optional Comma-separated list of SIC codes.

sort string optional Sort field. Valid values: scoopId, originalPublishedDate, description, link, linkText. Prefix with - for descending.

state string optional State or province of the company's address.

tool_version string optional Tool version override

updatedSinceCreation boolean optional Set 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.

Name Type Required Description

buyerPersonaId string required UUID of the buyer persona.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

competitorId string required UUID of the competitor.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

offeringId string required UUID of the product or service.

schema_version string optional Schema version override

tool_version string optional Schema version override

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

Restore a previously archived ICP to active status.

Name Type Required Description

segmentId string required UUID of the ICP segment.

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

audienceId string required UUID of the audience to update.

description string optional Updated description.

folderId string optional UUID of the folder to move the audience to.

name string optional New display name.

notes string optional Updated notes.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

columnId string required UUID of the column to update.

isFrozen boolean optional Whether the column is pinned to the left in grid views.

isHidden boolean optional Whether the column is hidden from grid views.

name string optional New display name for the column.

schema_version string optional Schema version override

tool_version string optional Schema 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).

Name Type Required Description

folderId string required UUID of the folder to update.

description string optional Updated description.

name string optional New display name for the folder.

notes string optional Updated notes.

schema_version string optional Schema version override

starred boolean optional Whether the folder is starred.

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required ID of the audience to update.

name string required New name for the audience.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required ID of the marketing audience.

fields array required Schema defining which fields are in each record.

operationType string required Type of upload operation.

records array required List of records to upload, each matching the field schema order.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

matchCriteria array optional Array of column-to-ZoomInfo-attribute mappings.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

audienceId string required UUID of the audience.

rows array required Array of row objects to create or update (max 500).

columns array optional Column IDs to enrich (only used when runEnrichment=true).

runEnrichment boolean optional Whether to run enrichment after upsert.

schema_version string optional Schema version override

tool_version string optional Schema 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.

Name Type Required Description

customFields array optional Custom key-value fields for extended persona metadata.

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

id string optional Persona ID to update. Omit to create a new persona.

name string optional Name of the buyer persona (required for creation, 1-1024 chars).

personalObjectives string optional Personal objectives, KPIs, and success metrics that drive this persona's purchasing decisions. Max 10,000 chars.

relevantOfferings string optional Offerings from your portfolio that this persona would be interested in. Max 10,000 chars.

schema_version string optional Schema version override

titlesFunctionsSeniority string optional Typical job titles, functional areas, and seniority levels for this persona. Max 10,000 chars.

tool_version string optional Tool version override

whatDoesThisPersonaCareAbout string optional Messaging 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.

Name Type Required Description

competitiveProducts string optional Your own products that directly compete with this competitor. Max 10,000 chars.

competitorProducts string optional Competitor products that overlap with your portfolio. Max 10,000 chars.

customersWeWon string optional Accounts won from this competitor. Useful for competitive proof points. Max 10,000 chars.

customFields array optional Custom key-value fields for extended competitor intelligence.

description string optional Detailed description of the competitor including market position and strengths. Max 10,000 chars.

id string optional Competitor ID to update. Omit to create a new competitor.

name string optional Name of the competitor company (required for creation, 1-1024 chars).

reasonsTheyLose string optional Why this competitor loses deals — weaknesses and gaps where you hold an advantage. Max 10,000 chars.

reasonsTheyWin string optional Why this competitor wins deals — key strengths and differentiators. Max 10,000 chars.

schema_version string optional Schema version override

tool_version string optional Tool version override

url string optional Competitor'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.

Name Type Required Description

actionPerformedAt string required Required. Timestamp when the interaction started (ISO 8601).

channel string required Required. Source or medium of the interaction.

companyDomain string required Required. Company domain of the participant.

contentType string required Required. Category or format of the content.

engagementId string required Required. Unique content interaction identifier.

instanceId string required Required. Unique identifier of the customer's organization in the external platform.

interactionType string required Required. Specific action performed.

status string required Required. Interaction status.

companyName string optional Participant company name.

duration integer optional Length of interaction in seconds.

email string optional Participant email address.

endedAt string optional Timestamp when the interaction ended (ISO 8601).

firstName string optional Participant first name.

instanceUrl string optional URL of the customer's organization in the external platform.

interactionDetails object optional Additional interaction attributes as key-value pairs.

lastName string optional Participant last name.

phoneNumber string optional Participant phone number.

schema_version string optional Schema version override

targetName string optional Target name.

targetUrl string optional Target URL of the interaction.

title string optional Participant job title.

tool_version string optional Schema 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.

Name Type Required Description

competitors string optional Text description of competitors relevant to this product. Max 10,000 chars.

customFields array optional Custom key-value fields for extended product metadata.

description string optional Detailed description including purpose, target audience, and key benefits. Max 10,000 chars.

id string optional Product/service ID to update. Omit to create a new record.

idealCompanySegment string optional Text description of the ideal company segment for this product. Max 10,000 chars.

name string optional Name of the product or service (required for creation, 1-1024 chars).

offeringBuyerPersonas string optional Text description of the buyer personas relevant to this product. Max 10,000 chars.

painPoints array optional Customer pain points this product addresses. Array of strings, max 100 items.

proofPoints array optional Reviews, testimonials, or case-study references validating effectiveness. Array of strings, max 100 items.

schema_version string optional Schema version override

tool_version string optional Tool version override

url string optional URL of the product or service webpage. Max 1,024 chars.

valueProposition array optional Key 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.

Name Type Required Description

customFields array optional Custom key-value fields for extended ICP criteria.

description string optional Description of the ICP including industry, company size, revenue range, and geography. Max 10,000 chars.

id string optional ICP segment ID to update. Omit to create a new ICP.

name string optional Name of the ICP (required for creation, 1-1024 chars).

schema_version string optional Schema version override

tool_version string optional Tool 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.

Name Type Required Description

customFields array optional Custom key-value fields for extended settings.

description string optional Company description including market position and target audience (max 10,000 chars).

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

name string optional Editable display name for the customer organization (max 1,024 chars).

schema_version string optional Schema version override

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

tool_version string optional Tool version override