# Zoominfo

ZoomInfo is a go-to-market intelligence platform that provides AI-powered B2B data and sales intelligence to help GTM teams find in-market buyers, build pipeline, and close deals faster.

- **Category:** crm
- **Auth:** OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `ZOOMINFO`
- **Version:** 20260211_00

## Tools

### Company Enrich

**Slug:** `ZOOMINFO_ENRICH_COMPANY`

Company Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companyId` | string | Yes | Unique ZoomInfo identifier for a company |
| `ipAddress` | string | Yes | IP address associated with the company |
| `companyFax` | string | Yes | Fax number of the company headquarters |
| `companyCity` | string | Yes | City for the company's primary address |
| `companyName` | string | Yes | Company name |
| `companyPhone` | string | Yes | Phone number of the company headquarters |
| `companyState` | string | Yes | Company state (U.S.) or province (Canada). You can use free text state or province names (e.g., 'new hampshire'), the two-letter common abbreviation for a U.S. state (e.g., 'nh'), or values provided in the State lookup endpoint. |
| `companyStreet` | string | Yes | Street address for the company's primary address |
| `companyTicker` | string | Yes | Company stock ticker symbol |
| `companyCountry` | string | Yes | Country for the company's primary address. You can use free text or see the Country lookup endpoint for values. |
| `companyWebsite` | string | Yes | Company website URL in http://www.example.com format |
| `companyZipCode` | string | Yes | Zip Code or Postal Code for the company's primary address |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Contact Enrich

**Slug:** `ZOOMINFO_ENRICH_CONTACT`

Contact Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Contact direct or mobile phone number |
| `fullName` | string | Yes | Contact full name |
| `jobTitle` | string | Yes | Contact title at current place of employment |
| `lastName` | string | Yes | Contact last name |
| `personId` | string | Yes | Unique ZoomInfo identifier for the contact |
| `companyId` | string | Yes | Unique ZoomInfo identifier for the company |
| `firstName` | string | Yes | Contact first name |
| `companyName` | string | Yes | Name of the company for which the contact works, or has worked |
| `externalURL` | string | Yes | Social media URLs for the contact (e.g., Facebook, Twitter, LinkedIn) |
| `hashedEmail` | string | Yes | Hashed email value for the contact. Allows matching via an email address with the extra security of not exposing the email. Supported hash algorithms are: MD5, SHA1, SHA256 and SHA512. |
| `emailAddress` | string | Yes | Business or Personal email address for the contact in example@example.com format |
| `validDateAfter` | string | Yes | The date after which the contact's profile was last validated in YYYY-MM-DD format |
| `lastUpdatedDateAfter` | string | Yes | The date after which the contact's profile was last updated in YYYY-MM-DD format |
| `contactAccuracyScoreMin` | integer | Yes | Return contacts that meet the minimum accuracy score or higher |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Intent Enrich

**Slug:** `ZOOMINFO_ENRICH_INTENT`

Intent Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | Yes | Limits the results returned to the given number of results per page. Default is 25. |
| `page` | integer | Yes | Provides the results for the given page, used in conjunction with rpp |
| `sortBy` | string | Yes | Sort results by valid output fields. Valid values are: signalDate, signalScore, category, topic, audienceStrength. |
| `topics` | string | Yes | Intent topics. Separate multiple topics with the pipe symbol. See the Intent Topics lookup endpoint for values. |
| `companyId` | string | Yes | Unique ZoomInfo identifier for a company |
| `sortOrder` | string | Yes | Provide sortBy if specifying sortOrder. Valid values are asc, ascending, desc, and descending. By default, results are sorted in descending order. |
| `companyName` | string | Yes | Company name |
| `signalEndDate` | string | Yes | End date for a company signaling interest in a topic |
| `companyWebsite` | string | Yes | Company website URL in http://www.example.com format |
| `signalScoreMax` | integer | Yes | Maximum signal score. Use with signalScoreMin to form a range. Minimum score is 60 and maximum is 100. |
| `signalScoreMin` | integer | Yes | Minimum signal score. Use with signalScoreMax to form a range. Minimum score is 60 and maximum is 100. |
| `signalStartDate` | string | Yes | Start date for a company signaling interest in a topic |
| `audienceStrengthMax` | string | Yes | Maximum audience strength score. Use with audienceStrengthMin to form a range. Values are A, B, C, D, and E, with A indicating a larger audience. |
| `audienceStrengthMin` | string | Yes | Minimum audience strength score. Use with audienceStrengthMax to form a range. Values are A, B, C, D, and E, with A indicating a larger audience. |
| `findRecommendedContacts` | boolean | Yes | Choose whether to get the recommended contacts using the findRecommendedContacts flag. Default is true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Location Enrich

**Slug:** `ZOOMINFO_ENRICH_LOCATION`

Location Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companyId` | string | Yes | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### News Enrich

**Slug:** `ZOOMINFO_ENRICH_NEWS`

News Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | array | Yes | Search news by text contained in URL strings. You must specify a minimum of 5 characters per input. |
| `page` | integer | Yes | Provides the results for the given page. Used in conjunction with limit. |
| `limit` | integer | Yes | Number of articles to return per page. The maximum limit is 100. |
| `companyId` | string | Yes | Unique ZoomInfo identifier for a company |
| `categories` | string | Yes | Category of news articles. See the News Categories endpoint for values. |
| `pageDateMax` | string | Yes | Specify the latest publishing date for news articles. For example, 2020-01-31 will return all new articles published on or before Jan 31, 2020. |
| `pageDateMin` | string | Yes | Specify the earliest publishing date for news articles returned. For example, 2020-01-01 will return all news articles published on or after Jan 1, 2020. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scoop Enrich

**Slug:** `ZOOMINFO_ENRICH_SCOOP`

Scoop Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | Yes | Limits the results returned to the given number of results per page. Default is 25. |
| `page` | integer | Yes | Provides the results for the given page, used in conjunction with rpp |
| `sortBy` | string | Yes | Sort results by valid output fields: scoopId, originalPublishedDate, description, link, or linkText |
| `scoopId` | string | Yes | ZoomInfo unique identifier for a scoop. Will accept a comma-separated list. |
| `companyId` | string | Yes | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |
| `scoopType` | string | Yes | Retrieve scoops based on type (e.g., earnings, awards, partnerships and so on). See the Scoop Types lookup endpoint for valid inputs. |
| `sortOrder` | string | Yes | Provide sortBy if specifying sortOrder. Valid values are asc, ascending, desc, and descending. By default, results are sorted in descending order. |
| `department` | string | Yes | Retrieve scoops based on department (IT, finance, HR and so on). See the Scoop Departments lookup endpoint for valid inputs. |
| `scoopTopic` | string | Yes | Retrieve scoops based on topic (e.g., integrations, technology, compliance and so on). See the Scoop Topics lookup endpoint for valid inputs. |
| `companyName` | string | Yes | Company name |
| `description` | string | Yes | Search for scoops based on description. Will accept a comma-separated list of keywords. |
| `companyWebsite` | string | Yes | Company domain |
| `publishedEndDate` | string | Yes | Ending date to search for scoops based on when published. Form a range using publishedEndDate. Uses YYYY-MM-DD format. |
| `publishedStartDate` | string | Yes | Starting date to search for scoops based on when published. Form a range using publishedEndDate or omit publishedEndDate to search to the current date. Uses YYYY-MM-DD format. |
| `updatedSinceCreation` | boolean | Yes | Include scoops that have been updated since publishedStartDate |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Technology Enrich

**Slug:** `ZOOMINFO_ENRICH_TECHNOLOGY`

Technology Enrich

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companyId` | string | Yes | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Company Search

**Slug:** `ZOOMINFO_SEARCH_COMPANY`

Returns a list of Companies from ZoomInfo's data which meet the specified search criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | No | Limits the results returned to the given number of results per page. Default is 25. |
| `page` | integer | Yes | Provides the results for the given page, used in conjunction with rpp |
| `state` | string | Yes | Company state (U.S.) or province (Canada). You can use free text state or province names (e.g., 'new hampshire'), the two-letter common abbreviation for a U.S. state (e.g., 'nh'), or values provided in the State lookup endpoint for values. |
| `sortBy` | string | Yes | Sort results by valid output fields: name, employeeCount, revenue |
| `street` | string | Yes | Company street |
| `address` | string | Yes | Company address |
| `country` | string | Yes | Country for the company's primary address. You can use free text or see the Country lookup endpoint for values. |
| `revenue` | string | Yes | Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. See the Revenue Range lookup endpoint for values. Alternatively, to get more granular ranges, you can use the revenueMin and revenueMax parameters. |
| `zipCode` | string | Yes | Zip Code of the company's primary address |
| `parentId` | string | Yes | ZoomInfo Company ID for parent company |
| `sicCodes` | string | Yes | The Standard Industrial Classification is a system for classifying industries by a four-digit code. See the SIC Codes lookup endpoint for values. |
| `certified` | integer | Yes | Denotes if ZoomInfo's research and data team has confirmed activity within the past 12 months |
| `companyId` | string | Yes | ZoomInfo unique identifier for the company. Will accept-comma-separated list. |
| `continent` | string | Yes | Continent for the company's primary address. See the Continent lookup endpoint for values. |
| `sortOrder` | string | Yes | Provide sortBy if specifying sortOrder. Valid values are asc, ascending, desc, and descending. By default, results are sorted in descending order. |
| `naicsCodes` | string | Yes | The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy. See the NAICS Codes lookup endpoint for values. |
| `revenueMax` | integer | Yes | Maximum annual revenue for a company in U.S. dollars. Use with revenueMin to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `revenueMin` | integer | Yes | Minimum annual revenue for a company in U.S. dollars. Use with revenueMax to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `companyName` | string | Yes | Company name |
| `companyType` | string | Yes | Company type (private, public, and so on). See the Company Type lookup endpoint for values. |
| `metroRegion` | string | Yes | Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `subUnitTypes` | string | Yes | Company sub types (e.g., division, subsidiary and so on). See the Sub Unit Type lookup endpoint for values. |
| `businessModel` | array | Yes | Search using Business Model (B2C, B2B, B2G) for a company. Default is All |
| `companyTicker` | array | Yes | Company stock ticker symbol |
| `employeeCount` | string | Yes | Employee count range. Accepts a comma-separated list of values. See the Employee Count lookup endpoint for values. Alternatively, to get more granular ranges, you can use the employeeRangeMin and employeeRangeMax parameters. |
| `hashTagString` | string | Yes | Hash tags for a company. Can include a comma-separated list. |
| `industryCodes` | string | Yes | Top-level Industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. See the Industry Codes lookup endpoint for values. |
| `companyRanking` | string | Yes | Company ranking list (e.g., Fortune 500 and so on). See the Company Ranking lookup endpoint for values. |
| `companyWebsite` | string | Yes | URL to the company website in http://www.example.com format |
| `engagementType` | array | Yes | List of engagement types to search for. Accepted values are a list of email, phone, online meeting. |
| `fundingEndDate` | string | Yes | End date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `excludedRegions` | string | Yes | Exclude a company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `employeeRangeMax` | string | Yes | Maximum employee count for a company. Use with employeeRangeMin to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `employeeRangeMin` | string | Yes | Minimum employee count for a company. Use with employeeRangeMax to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `fundingAmountMax` | integer | Yes | Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMax is used without fundingAmountMin, the result will be the amount specified or less. |
| `fundingAmountMin` | integer | Yes | Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMin is used without fundingAmountMax, the result will be the amount specified or greater. |
| `fundingStartDate` | string | Yes | Start date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `industryKeywords` | string | Yes | Industry keywords associated with a company. Can include either 'AND' or 'OR' operators. For example, 'software AND security' or 'software OR security'. |
| `ultimateParentId` | string | Yes | ZoomInfo Company ID for ultimate parent company |
| `engagementEndDate` | string | Yes | Engagement end date in YYYY-MM-DD format. EngagementStartDate is required. |
| `companyDescription` | string | Yes | Text description unique to the company you want to use as search criteria |
| `locationSearchType` | string | Yes | Location criteria for search. Values are PersonOrHQ, PersonAndHQ, Person, HQ, PersonThenHQ. |
| `zipCodeRadiusMiles` | string | Yes | Used in conjunction with zipCode, designates a geographical radius (in miles) from the zipCode provided. |
| `engagementStartDate` | string | Yes | Engagement start date in YYYY-MM-DD format. |
| `zoominfoContactsMax` | string | Yes | Maximum number of ZoomInfo contacts associated with company |
| `zoominfoContactsMin` | string | Yes | Minimum number of ZoomInfo contacts associated with company |
| `techAttributeTagList` | string | Yes | Specify technology product tags. See the Tech - Product lookup endpoint for values. This string uses a numerical dot notation format similar to an IP address. The notation denotes the hierarchical structure: parent-category.category.vendor. For example, 333.202.28. You can use wildcards in the notation (e.g., 333.202.\\*, \\*.202.\\*, and so on). |
| `primaryIndustriesOnly` | boolean | No | Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. Default is false. |
| `excludeDefunctCompanies` | boolean | No | Include or exclude defunct companies. The default value is false. |
| `oneYearEmployeeGrowthRateMax` | string | Yes | Maximum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMin to set a range. |
| `oneYearEmployeeGrowthRateMin` | string | Yes | Minimum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMax to set a range. |
| `twoYearEmployeeGrowthRateMax` | string | Yes | Maximum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMin to set a range. |
| `twoYearEmployeeGrowthRateMin` | string | Yes | Minimum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMax to set a range. |
| `companyStructureIncludedSubUnitTypes` | string | Yes | Company hierarchical structure |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Company Search Inputs

**Slug:** `ZOOMINFO_SEARCH_COMPANY_INPUT`

Returns a list of fields you can use as input for the Company Search Action.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Contact Search

**Slug:** `ZOOMINFO_SEARCH_CONTACT`

Returns a list of Contacts from ZoomInfo's data that meet the specified search criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | No | Limits the results returned to the given number of results per page. Default is 25. |
| `page` | integer | No | Provides the results for the given page, used in conjunction with rpp |
| `phone` | array | No | List of person phones or mobile numbers. Here's an example list - any of the following phone number formats are acceptable: ['(123)-456-7890', '1234567890', '123 456 7890', '123-445-7890']. Alphabetical characters are not allowed. |
| `state` | string | No | Company state (U.S.) or province (Canada). You can use free text state or province names (e.g., 'new hampshire'), the two-letter common abbreviation for a U.S. state (e.g., 'nh'), or values provided in the State lookup endpoint. |
| `degree` | string | No | Contact education degree |
| `school` | string | No | Contact educational institution |
| `sortBy` | string | No | Sort results by valid output fields: contactAccuracyScore, lastName, companyName, hierarchy, sourceCount, lastMentioned, relevance |
| `street` | string | No | Company street |
| `address` | string | No | Company address |
| `country` | string | No | Country for the company's primary address. You can use free text or see the Country lookup endpoint for values. |
| `revenue` | string | No | Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. See the Revenue Range lookup endpoint for values. Alternatively, to get more granular ranges, you can use the revenueMin and revenueMax parameters. |
| `zipCode` | string | No | Zip Code of the company's primary address |
| `fullName` | string | No | Contact full name |
| `jobTitle` | string | No | Contact title at current place of employment. Use OR to input multiple job titles. |
| `lastName` | string | No | Contact last name |
| `parentId` | string | No | ZoomInfo Company ID for parent company |
| `personId` | string | No | Unique ZoomInfo identifier for the contact. Can include a comma-separated list. |
| `sicCodes` | string | No | The Standard Industrial Classification is a system for classifying industries by a four-digit code. See the SIC Codes lookup endpoint for values. |
| `companyId` | string | No | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |
| `continent` | string | No | Continent for the company's primary address. See the Continent lookup endpoint for values. |
| `firstName` | string | No | Contact first name |
| `sortOrder` | string | No | Provide sortBy if specifying sortOrder. Valid values are asc, ascending, desc, and descending. By default, results are sorted in descending order. |
| `department` | string | No | Contact department at current place of employment. See the Contact Departments lookup endpoint for values. |
| `naicsCodes` | string | No | The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy. See the NAICS Codes lookup endpoint for values. |
| `revenueMax` | integer | No | Maximum annual revenue for a company in U.S. dollars. Use with revenueMin to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `revenueMin` | integer | No | Minimum annual revenue for a company in U.S. dollars. Use with revenueMax to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `techSkills` | array | No | List of technology skills for a contact. Default criteria is OR between multiple values. Should only contain string numbers |
| `boardMember` | string | No | Exclude or include board members from search results. By default, the API includes board members in results. See the Board Members lookup endpoint for values. |
| `companyName` | string | No | Company name. Can use OR and NOT operators to include or exclude companies by name. For example, 'Vodaphone OR Comcast NOT Verizon' |
| `companyType` | string | No | Company type (private, public, and so on). See the Company Type lookup endpoint for values. |
| `hashedEmail` | string | No | Hashed email value for the contact. Allows searching via an email address with the extra security of not exposing the email. Supported hash algorithms are: MD5, SHA1, SHA256 and SHA512. |
| `jobFunction` | string | No | Contact job function at their current place of employment. See the Job Function lookup endpoint for values. |
| `metroRegion` | string | No | Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `emailAddress` | string | No | Work email address for the contact in example@example.com format |
| `subUnitTypes` | string | No | Company sub types (e.g., division, subsidiary and so on). See the Sub Unit Type lookup endpoint for values. |
| `companyTicker` | array | No | Company stock ticker symbol |
| `employeeCount` | string | No | Employee count range. Accepts a comma-separated list of values. See the Employee Count lookup endpoint for values. Alternatively, to get more granular ranges, you can use the employeeRangeMin and employeeRangeMax parameters. |
| `hashTagString` | string | No | Hash tags for a company. Can include a comma-separated list. |
| `industryCodes` | string | No | Top-level industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. See the Industry Codes lookup endpoint for values. |
| `middleInitial` | string | No | Contact middle initial |
| `webReferences` | array | No | List of web references for a contact. Default criteria is OR between multiple values. Should only contain english letters and numbers. |
| `companyRanking` | string | No | Company ranking list (e.g., Fortune 500 and so on). See the Company Ranking lookup endpoint for values. |
| `companyWebsite` | string | No | URL to the company website in http://www.example.com format |
| `engagementType` | array | No | List of engagement types to search for. Accepted values are a list of email, phone, online meeting. |
| `executivesOnly` | boolean | No | Return only executives |
| `fundingEndDate` | string | No | End date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `requiredFields` | string | No | Specify a list of required fields for each record returned. Can include email, phone (direct or company), directPhone, personalEmail, and mobilePhone. Can include a comma-separated list of these fields. For example, requiring direct phone (directPhone) will only return contacts which have the Direct Phone Number field populated. |
| `validDateAfter` | string | No | The date after which the contact's profile was last validated in YYYY-MM-DD format |
| `excludeJobTitle` | string | No | Exclude comma-separated list of job titles |
| `excludedRegions` | string | No | Exclude a company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `hasBeenNotified` | string | No | Contacts who have been notified of inclusion in ZoomInfo's database. Values are exclude, include, and only. |
| `managementLevel` | string | No | Contact management level at current place of employment. See the Management Levels lookup endpoint for values. |
| `employeeRangeMax` | string | No | Maximum employee count for a company. Use with employeeRangeMin to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `employeeRangeMin` | string | No | Minimum employee count for a company. Use with employeeRangeMax to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `fundingAmountMax` | integer | No | Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMax is used without fundingAmountMin, the result will be the amount specified or less. |
| `fundingAmountMin` | integer | No | Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMin is used without fundingAmountMax, the result will be the amount specified or greater. |
| `fundingStartDate` | string | No | Start date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `industryKeywords` | string | No | Industry keywords associated with a company. Can include a comma-separated list. |
| `ultimateParentId` | string | No | ZoomInfo Company ID for ultimate parent company |
| `engagementEndDate` | string | No | Engagement end date in YYYY-MM-DD format. EngagementStartDate is required. |
| `locationCompanyId` | array | No | Searches by contact's location IDs. Use the Location Enrich endpoint to obtain a list of location IDs for a company. |
| `supplementalEmail` | array | No | Supplemental email address for the contact in example@example.com format |
| `yearsOfExperience` | string | No | Years of overall experience. Must be a comma-separated string of values. See the Years of Experience lookup endpoint for values. |
| `companyDescription` | string | No | Text description unique to the company you want to use as search criteria |
| `locationSearchType` | string | No | Location criteria for search. Values are PersonOrHQ, PersonAndHQ, Person, HQ, PersonThenHQ. |
| `zipCodeRadiusMiles` | string | No | Used in conjunction with zipCode, designates a geographical radius (in miles) from the zipCode provided. |
| `engagementStartDate` | string | No | Engagement start date in YYYY-MM-DD format. |
| `lastUpdatedInMonths` | integer | No | Number of months within which the contact's profile was last updated. For example, if lastUpdatedinMonths is 12 only contacts that were updated in the last 12 months will be returned. |
| `zoominfoContactsMax` | string | No | Maximum number of ZoomInfo contacts associated with company |
| `zoominfoContactsMin` | string | No | Minimum number of ZoomInfo contacts associated with company |
| `companyPastOrPresent` | string | No | Returns companies based on a contact's work history. Values are present (default), past, and pastAndPresent. |
| `lastUpdatedDateAfter` | string | No | The date after which the contact's profile was last updated in YYYY-MM-DD format |
| `positionStartDateMax` | string | No | Maximum date for when a contact began current employment. Use with positionStartDateMin to set a range. |
| `positionStartDateMin` | string | No | Minimum date for when a contact began current employment. Use with positionStartDateMax to set a range. |
| `techAttributeTagList` | string | No | Specify technology product tags. See the Tech - Product lookup endpoint for values. This string uses a numerical dot notation format similar to an IP address. The notation denotes the hierarchical structure: parent-category.category.vendor. For example, 333.202.28. You can use wildcards in the notation (e.g., 333.202.\*, \*.202.\*, and so on). |
| `primaryIndustriesOnly` | boolean | No | Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. Default is false. |
| `excludeManagementLevel` | string | No | Exclude contact based on management level. See the Management Levels lookup endpoint for values. |
| `excludePartialProfiles` | boolean | No | Contacts who do not have an active company associated with them are considered partial profiles. Exclude contacts with a partial profile from search results. |
| `contactAccuracyScoreMax` | string | No | Maximum accuracy score for search results. This score indicates the likelihood that a contact is reachable and still employed by the company listed. Minimum score is 70 and maximum is 99. |
| `contactAccuracyScoreMin` | string | No | Minimum accuracy score for search results. This score indicates the likelihood that a contact is reachable and still employed by the company listed. Minimum score is 70 and maximum is 99. |
| `filterByBuyingCommittee` | boolean | No | Boolean flag for Buying Committee. Setting this to TRUE will filter the results based on the Buying Committees set for the account. Default is FALSE. |
| `oneYearEmployeeGrowthRateMax` | string | No | Maximum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMin to set a range. |
| `oneYearEmployeeGrowthRateMin` | string | No | Minimum one year employee growth rate for a company. Use with oneYearEmployeeGrowthRateMax to set a range. |
| `twoYearEmployeeGrowthRateMax` | string | No | Maximum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMin to set a range. |
| `twoYearEmployeeGrowthRateMin` | string | No | Minimum two year employee growth rate for a company. Use with twoYearEmployeeGrowthRateMax to set a range. |
| `companyStructureIncludedSubUnitTypes` | string | No | Company hierarchical structure |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Contact Search Inputs

**Slug:** `ZOOMINFO_SEARCH_CONTACT_INPUT`

Returns a list of fields you can use as input for the Contact Search Action.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Intent Search Inputs

**Slug:** `ZOOMINFO_SEARCH_INTENT_INPUT`

Returns a list of fields you can use as input for the Intent Action.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### News Search

**Slug:** `ZOOMINFO_SEARCH_NEWS`

Returns a list of news articles from ZoomInfo's data which meet the specified search criteria. All inputs are optional, but you must use at least one input parameter to generate a successful response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | No | Limits the results returned to the given number of results per page. The default is 25 and the maximum rpp supported is 100. |
| `url` | array | Yes | Search news by text contained in URL strings. You must specify a minimum of 5 characters per input. |
| `page` | integer | Yes | Provides the results for the given page, used in conjunction with rpp. The maximum page number supported is 1000. |
| `categories` | array | Yes | Category of news articles. Accepts an array of strings. See the News Categories lookup endpoint for values. |
| `pageDateMax` | string | Yes | Specify the latest publishing date for news articles returned. For example, 2020-01-31 will return all news articles published on or before Jan 31, 2020. |
| `pageDateMin` | string | Yes | Specify the earliest publishing date for news articles returned. For example, 2020-01-01 will return all news articles published on or after Jan 1, 2020. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### News Search Inputs

**Slug:** `ZOOMINFO_SEARCH_NEWS_INPUT`

Returns a list of fields you can use as input for the News Search endpoint.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scoop Search

**Slug:** `ZOOMINFO_SEARCH_SCOOP`

Returns a list of Scoops from ZoomInfo's data which meet the specified search criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rpp` | integer | No | Limits the results returned to the given number of results per page. Default is 25. |
| `page` | integer | Yes | Provides the results for the given page, used in conjunction with rpp |
| `state` | string | Yes | Company state (U.S.) or province (Canada). You can use free text state or province names (e.g., 'new hampshire'), the two-letter common abbreviation for a U.S. state (e.g., 'nh'), or values provided in the State lookup endpoint. |
| `sortBy` | string | Yes | Sort results by valid output fields: scoopId, originalPublishedDate, description, url, urlText |
| `street` | string | Yes | Company street |
| `address` | string | Yes | Company address |
| `country` | string | Yes | Country for the company's primary address. You can use free text or see the Country lookup endpoint for values. |
| `revenue` | string | Yes | Annual revenue range in U.S. dollars. Accepts a comma-separated list of values. See the Revenue Range lookup endpoint for values. Alternatively, to get more granular ranges, you can use the revenueMin and revenueMax parameters. |
| `scoopId` | string | Yes | ZoomInfo unique identifier for a scoop. Will accept a comma-separated list. |
| `zipCode` | string | Yes | Zip Code of the company's primary address |
| `parentId` | string | Yes | ZoomInfo Company ID for parent company |
| `sicCodes` | string | Yes | The Standard Industrial Classification is a system for classifying industries by a four-digit code. See the SIC Codes lookup endpoint for values. |
| `companyId` | string | Yes | ZoomInfo unique identifier for the company. Will accept a comma-separated list. |
| `continent` | string | Yes | Continent for the company's primary address. See the Continent lookup endpoint for values. |
| `scoopType` | string | Yes | Retrieve scoops based on type (e.g., earnings, awards, partnerships and so on). See the Scoop Types lookup endpoint for values. |
| `sortOrder` | string | Yes | Provide sortBy if specifying sortOrder. Valid values are asc, ascending, desc, and descending. By default, results are sorted in descending order. |
| `department` | string | Yes | Retrieve scoops based on department (IT, finance, HR and so on). See the Scoop Departments lookup endpoint for values. |
| `naicsCodes` | string | Yes | The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy. See the NAICS Codes lookup endpoint for values. |
| `revenueMax` | integer | Yes | Maximum annual revenue for a company in U.S. dollars. Use with revenueMin to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `revenueMin` | integer | Yes | Minimum annual revenue for a company in U.S. dollars. Use with revenueMax to set a range. Alternatively, you can use the revenue parameter to search for pre-defined ranges. |
| `scoopTopic` | string | Yes | Retrieve scoops based on topic (e.g., integrations, technology, compliance and so on). See the Scoop Topics lookup endpoint for values. |
| `companyName` | string | Yes | Company name |
| `companyType` | string | Yes | Company type (private, public, and so on). See the Company Type lookup endpoint for values. |
| `description` | string | Yes | Search for scoops based on description. Will accept a comma-separated list of keywords. |
| `metroRegion` | string | Yes | Company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `subUnitTypes` | string | Yes | Company sub types (e.g., division, subsidiary and so on). See the Sub Unit Type lookup endpoint for values. |
| `employeeCount` | string | Yes | Employee count range. Accepts a comma-separated list of values. See the Employee Count lookup endpoint for values. Alternatively, to get more granular ranges, you can use the employeeRangeMin and employeeRangeMax parameters. |
| `hashTagString` | string | Yes | Hash tags for the company. Can include a comma-separated list. Default AND operation with multiple inputs. |
| `industryCodes` | string | Yes | Top-level Industry that the contact works in. A contact can have multiple top level industries. Tags are based on the contact's current company. Can include a comma-separated list. See the Industry Codes lookup endpoint for values. |
| `companyRanking` | string | Yes | Company ranking list (e.g., Fortune 500 and so on). See the Company Ranking lookup endpoint for values. |
| `companyWebsite` | string | Yes | URL to the company website in http://www.example.com format |
| `fundingEndDate` | string | Yes | End date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `excludedRegions` | string | Yes | Exclude a company metro area. Accepts a comma-separated list of U.S. and Canada metro areas. See the Metro Area lookup endpoint for values. |
| `employeeRangeMax` | string | Yes | Maximum employee count for a company. Use with employeeRangeMin to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `employeeRangeMin` | string | Yes | Minimum employee count for a company. Use with employeeRangeMax to set a range. Alternatively, you can use the employeeCount parameter to search for pre-defined ranges. |
| `fundingAmountMax` | integer | Yes | Maximum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMax is used without fundingAmountMin, the result will be the amount specified or less. |
| `fundingAmountMin` | integer | Yes | Minimum funding amount in thousands (e.g., 1 = 1000, 500 = 500,000). If fundingAmountMin is used without fundingAmountMax, the result will be the amount specified or greater. |
| `fundingStartDate` | string | Yes | Start date of the funding in YYYY-MM-DD format. If fundingStartDate and fundingEndDate are both specified, they will be used as a range. Start date after end date returns an error. If start date and end date are the same, will return results for exact date. |
| `industryKeywords` | string | Yes | Industry keywords associated with a company. Can include a comma-separated list. |
| `publishedEndDate` | string | Yes | Ending date to search for scoops based on when published. Form a range using publishedEndDate. Uses YYYY-MM-DD format. |
| `ultimateParentId` | string | Yes | ZoomInfo Company ID for ultimate parent company |
| `companyDescription` | string | Yes | Text description unique to the company you want to use as search criteria |
| `locationSearchType` | string | Yes | Location criteria for search. Values are PersonOrHQ, PersonAndHQ, Person, HQ, PersonThenHQ. |
| `publishedStartDate` | string | Yes | Starting date to search for scoops based on when published. Form a range using publishedEndDate or omit publishedEndDate to search to the current date. Uses YYYY-MM-DD format. |
| `zipCodeRadiusMiles` | string | Yes | Company Zip code radius |
| `zoominfoContactsMax` | string | Yes | Maximum number of ZoomInfo contacts associated with company |
| `zoominfoContactsMin` | string | Yes | Minimum number of ZoomInfo contacts associated with company |
| `techAttributeTagList` | string | Yes | Specify technology product tags |
| `updatedSinceCreation` | boolean | Yes | Include scoops that have been updated since publishedStartDate |
| `primaryIndustriesOnly` | boolean | No | Used in conjunction with the industryCodes input parameter. When set to true, any result returned must have one of the specified industries as a primary industry. If no industries are specified, then this parameter will be ignored. Default is false. |
| `companyStructureIncludedSubUnitTypes` | string | Yes |  |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Scoop Search Inputs

**Slug:** `ZOOMINFO_SEARCH_SCOOP_INPUT`

Returns a list of fields you can use as input for the Scoop Search Action.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |