View a markdown version of this page

ZoomInfo integration - Amazon Quick
Before you beginConfiguring ZoomInfoSetting up the connector in Amazon QuickAvailable actionsManaging and troubleshooting

ZoomInfo integration

With the ZoomInfo connector, you can look up company and contact data, and query firmographic and intent data directly in Amazon Quick through natural language.

Amazon Quick supports multiple authentication methods for ZoomInfo. Choose the method that best fits your organization's security requirements.

  • Default OAuth app – Uses an AWS-managed OAuth application. No additional credentials are needed. Users authenticate directly with their ZoomInfo account.

  • Custom OAuth app – Uses a customer-managed OAuth application. This option gives your organization full control over the OAuth configuration.

  • Service-to-Service OAuth – Uses client credentials for server-to-server authentication without user interaction. Suitable for automated workflows.

  • API Key – Uses an API key for authentication.

For more information about the authentication methods that Amazon Quick supports, see Authentication methods.

Before you begin

Make sure that you have the following before you set up the integration.

  • An active ZoomInfo account with access to the data products you want to query.

  • For Custom OAuth app or Service-to-Service OAuth: OAuth credentials from your ZoomInfo administrator. ZoomInfo uses Okta for OAuth.

  • For API Key: A ZoomInfo-issued API key.

  • For Amazon Quick subscription requirements, see Set up integrations in the console.

Configuring ZoomInfo

If you are using Default OAuth app authentication, skip this section and proceed to Setting up the connector in Amazon Quick.

For Custom OAuth app or Service-to-Service OAuth authentication, work with your ZoomInfo administrator to register an OAuth client in the ZoomInfo Okta tenant and add the Amazon Quick callback URL https://{region}.quicksight.aws.amazon.com/sn/oauthcallback as a redirect URI. Replace {region} with your AWS Region (for example, us-east-1). For step-by-step instructions, see ZoomInfo MCP Overview and Developer Portal Guide in the ZoomInfo documentation. Record the Client ID and Client Secret — you need them when you configure Amazon Quick. For API Key authentication, generate an API key from your ZoomInfo account.

Setting up the connector in Amazon Quick

Connect from the Available tab

If you want to use Default OAuth app authentication, you can connect directly from the Available tab without additional configuration.

  1. In the Amazon Quick console, choose Connectors.

  2. On the Available tab, find ZoomInfo and choose Connect.

  3. Complete the ZoomInfo sign-in flow and grant the requested permissions.

To configure a connector with one of the other authentication methods, use the Create for your team tab as described below.

Create from the Create for your team tab

  1. In the Amazon Quick console, choose Connectors.

  2. Choose the Create for your team tab.

  3. Find and choose ZoomInfo.

  4. Enter a Name for your connector. Optionally, choose + Add Description to add a description.

  5. For Connection type, choose Public network.

  6. For OAuth Configuration, choose one of the following authentication methods and configure the required fields.

    1. For Default OAuth app:

      No additional credentials are needed. Choose Next to continue.

    2. For Custom OAuth app, configure the following fields:

      • Client ID – The client ID from your ZoomInfo OAuth client.

      • Public OAuth client (Optional) – Select this option if your ZoomInfo OAuth client is configured as a public client (no client secret).

      • Client secret – The client secret from your ZoomInfo OAuth client.

      • Token URL – The token endpoint. Default: https://okta-login.zoominfo.com/oauth2/default/v1/token

      • Authorization URL – The authorization endpoint. Default: https://okta-login.zoominfo.com/oauth2/default/v1/authorize

      • Redirect URL – Pre-filled with the Amazon Quick callback URL.

    3. For Service-to-Service OAuth, configure the following fields:

      • Client ID – The client ID from your ZoomInfo OAuth client.

      • Client secret – The client secret from your ZoomInfo OAuth client.

      • Token URL – The token endpoint. Default: https://okta-login.zoominfo.com/oauth2/default/v1/token

    4. For API Key, configure the following fields:

      • API Key – The ZoomInfo API key.

      • Email (Optional) – The email address associated with the API key.

  7. Choose Next.

  8. If you chose Default OAuth app or Custom OAuth app, a ZoomInfo authorization window opens. Review the requested permissions and choose Allow.

  9. On the Review page, review the available actions for the connector. Choose Next.

  10. On the Publish page, choose who can access the connector. You can enable access for everyone in your organization or search for specific teams or groups.

  11. Choose Publish.

Available actions

After you set up the connector, the actions exposed by ZoomInfo are available. To see the current set of actions for your connector, go to the connector's Available actions view in the Amazon Quick console.

Managing and troubleshooting

To edit, share, or delete your connector, see Managing existing integrations.

Authentication issues

  • Sign-in fails (Default OAuth app or Custom OAuth app) – Verify that your ZoomInfo account is active. For Custom OAuth app, confirm that the redirect URI in your ZoomInfo OAuth client matches the Amazon Quick callback URL.

  • Invalid client credentials (Custom OAuth app or Service-to-Service OAuth) – Verify that the Client ID and Client secret match the values in your ZoomInfo OAuth client.

  • API Key authentication fails – Verify that the API key has not been revoked.