> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-jk-zoominfo-docs-extension.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ZoomInfo

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental read is supported only for `contacts`, `news` and `scoops` currently. For all other objects, a full read of the ZoomInfo instance will be done per scheduled read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://api.zoominfo.com`.

### Supported objects

The ZoomInfo connector supports reading from and writing to the following objects:

#### Read objects

* [agent-teams](https://docs.zoominfo.com/reference/agent-teams)
* [audience-folders](https://docs.zoominfo.com/reference/folders_listfolders)
* [audiences](https://docs.zoominfo.com/reference/audiences_listaudiences)
* [board-members](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [buying-groups](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [companies](https://docs.zoominfo.com/reference/searchinterface_searchcompany)
* [company-rankings](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [company-types](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [contacts](https://docs.zoominfo.com/reference/searchinterface_searchcontact)
* [continents](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [countries](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [customer-buyer-personas](https://docs.zoominfo.com/reference/customerbuyerpersonainterface_listcustomerbuyerpersonas)
* [customer-competitors](https://docs.zoominfo.com/reference/customercompetitorsinterface_listcustomercompetitors)
* [departments](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [employee-count](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [hashtags](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [ideal-company-profile](https://docs.zoominfo.com/reference/customeridealcompanysegmentinterface_listidealcompanysegments)
* [industries](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [intent-topics](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [job-functions](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [job-titles](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [management-levels](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [metro-regions](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [naics-codes](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [news](https://docs.zoominfo.com/reference/searchinterface_searchnews)
* [news-categories](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [products](https://docs.zoominfo.com/reference/organizationofferingsinterface_listorganizationofferings)
* [pulses](https://docs.zoominfo.com/reference/pulsescontroller_listpulses)
* [revenue-ranges](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [scoop-departments](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [scoop-topics](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [scoop-types](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [scoops](https://docs.zoominfo.com/reference/searchinterface_searchscoop)
* [sic-codes](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [states](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [sub-unit-types](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [tech-categories](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [tech-skills](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [tech-vendors](https://docs.zoominfo.com/reference/lookupinterface_lookup)
* [usage](https://docs.zoominfo.com/reference/userinterface_userusage)
* [years-of-experience](https://docs.zoominfo.com/reference/lookupinterface_lookup)

#### Write objects

* [audience-folders](https://docs.zoominfo.com/reference/folders_createfolder)
* [audiences](https://docs.zoominfo.com/reference/audiences_createaudience)
* [customer-buyer-personas](https://docs.zoominfo.com/reference/customerbuyerpersonainterface_upsertcustomerbuyerpersona)
* [customer-competitors](https://docs.zoominfo.com/reference/customercompetitorsinterface_upsertcustomercompetitor)
* [ideal-company-profile](https://docs.zoominfo.com/reference/customeridealcompanysegmentinterface_upsertidealcompanysegment)
* [products](https://docs.zoominfo.com/reference/organizationofferingsinterface_upsertorganizationoffering)

### Example integration

For an example manifest file of a ZoomInfo integration, visit our [samples repo on GitHub](https://github.com/amp-labs/samples/blob/main/zoominfo/amp.yaml).

## Before you get started

To connect ZoomInfo with Ampersand, you will need a ZoomInfo account with access to the [ZoomInfo Developer Portal](https://developer.zoominfo.com).

Once your account is created, you'll need to register an app in the Developer Portal and obtain the following credentials:

* Client ID
* Client Secret

You will then use these credentials to connect your application to Ampersand.

### Creating a ZoomInfo app

1. Log in to the [ZoomInfo Developer Portal](https://developer.zoominfo.com).

2. Click **Create App**.

3. Enter a descriptive name for your application, and select **OAuth 2.0 Authorization Code** as the authentication type.

4. Under redirect URIs, add: `https://api.withampersand.com/callbacks/v1/oauth`

5. Assign the OAuth scopes that your integration needs. Scopes define the specific types of data and actions your application can access.

6. Note the **Client ID** and **Client Secret**. You will need these to connect your app to Ampersand.

For more details, see the [ZoomInfo App Creation guide](https://docs.zoominfo.com/docs/app-creation-developer-portal-guide).

### Add your ZoomInfo app info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a ZoomInfo integration.

3. Select **Provider Apps**.

4. Select **ZoomInfo** from the **Provider** list.

5. Enter the **Client ID** and **Client Secret** obtained from your ZoomInfo app.

6. Click **Save Changes**.

## Using the connector

To start integrating with ZoomInfo:

* Create a manifest file like the [example above](#example-integration).
* Deploy it using the [amp CLI](/cli/overview).
* If you are using Read Actions, create a [destination](/destinations).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for OAuth authorization.
* Start using the connector!
  * If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
  * If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.