Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Zoominfo

Authentication & Authorization​

Zoominfo supports two authentication methods::

  • PKI Authentication (Recommended)
    • Client ID and Private Key required for authentication can be generated from the Zoominfo Admin Portal.
    • JWT token, generated during authentication, is valid for 5 minutes and is regenerated by the integration automatically when it expires.
  • Basic Authentication
    • Username and Password are required to return a JWT that is valid for one hour.
  • Publicly exposing your API credentials can allow unauthorized access to Zoominfo API endpoints by a third party. DataGrail stores your API credentials encrypted and protected.

Endpoints Utilized​

Limits​

  • The Zoominfo API uses different rate limits depending on the endpoint:

    • For the Authentication endpoint, the limit is 1 request per second.

    • For other endpoints, the limit is 1500 requests per minute.

  • DataGrail processes API responses with HTTP 429 status to interrupt requests, waiting and retrying.

Access​

For an access request, DataGrail will take the following actions:

  • Contact Search - search Contacts by data subject email. We extract the following fields:

    • contactAccuracyScore

    • firstName

    • hasCompanyCountry

    • hasCompanyEmployeeCount

    • hasCompanyIndustry

    • hasCompanyPhone

    • hasCompanyRevenue

    • hasCompanyState

    • hasCompanyStreet

    • hasCompanyZipCode

    • hasDirectPhone

    • hasEmail

    • hasMobilePhone

    • hasSupplementalEmail

    • Id

    • jobTitle

    • lastName

    • lastUpdatedDate

    • middleName

    • validDate

  • Contact Enrich - retrieving Contact details using data subject email as a query parameter. We extract the following fields:

    • Id

    • firstName

    • middleName

    • lastName

    • Email

    • hasCanadianEmail

    • Phone

    • directPhoneDoNotCall

    • Street

    • City

    • Region

    • metroArea

    • zipCode

    • State

    • Country

    • Continent

    • personHasMoved

    • withinEu

    • withinCalifornia

    • withinCanada

    • validDate

    • lastUpdatedDate

    • noticeProvidedDate

    • Salutation

    • Suffix

    • jobTitle

    • jobFunction

    • Education

    • hashedEmails

    • Picture

    • mobilePhoneDoNotCall

    • externalUrls

    • employmentHistory

    • managementLevel

    • contactAccuracyScore

    • positionStartDate

  • Filter search results of Contact Enrich: only records with matchStatus = FULL_MATCH or matchStatus = CONTACT_ONLY_MATCH are returned.

  • For all objects found, DataGrail will return a list of collected fields. Customer can edit which objects and fields he wants to provide to the Data Subject via our Portal Requests.

Endpoints Utilized​

Deletion​

DataGrail supports the Direct Contact Deletion workflow for Zoominfo.

 

Need help?
If you have any questions, please reach out to your dedicated CSM or contact us at support@datagrail.io.

Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.