Zoominfo API Authentication Client

Common errors

Warnings

Install

Imports

• authClient
  wrong

  import authClient from 'zoominfo-api-auth-client';

  correct

  const authClient = require('zoominfo-api-auth-client');

  The library primarily uses CommonJS `require`. Direct ES module `import` might not function as expected without transpilation or specific build configurations due to its CJS-centric design.

• getAccessTokenViaPKI
  wrong

  import { getAccessTokenViaPKI } from 'zoominfo-api-auth-client';

  correct

  const authClient = require('zoominfo-api-auth-client');
  authClient.getAccessTokenViaPKI('username', 'clientId', 'privateKey');

  Functions like `getAccessTokenViaPKI` are methods on the default exported object, not named exports. Access them via the `authClient` object.

• getAccessTokenViaBasicAuth
  wrong

  import { getAccessTokenViaBasicAuth } from 'zoominfo-api-auth-client';

  correct

  const authClient = require('zoominfo-api-auth-client');
  authClient.getAccessTokenViaBasicAuth('username', 'password');

  Similar to PKI authentication, this is a method on the `authClient` object. Direct named imports will result in a runtime error.

Quickstart

This quickstart demonstrates how to obtain an access token using the PKI authentication method, utilizing environment variables for secure credential handling and including basic error logging.

const authClient = require('zoominfo-api-auth-client');

const ZOOMINFO_USERNAME = process.env.ZOOMINFO_USERNAME ?? '';
const ZOOMINFO_CLIENT_ID = process.env.ZOOMINFO_CLIENT_ID ?? '';
const ZOOMINFO_PRIVATE_KEY = process.env.ZOOMINFO_PRIVATE_KEY ?? '';

async function authenticateAndGetToken() {
  if (!ZOOMINFO_USERNAME || !ZOOMINFO_CLIENT_ID || !ZOOMINFO_PRIVATE_KEY) {
    console.error('Missing ZoomInfo credentials in environment variables.');
    process.exit(1);
  }
  try {
    console.log('Attempting to retrieve access token via PKI...');
    const token = await authClient.getAccessTokenViaPKI(ZOOMINFO_USERNAME, ZOOMINFO_CLIENT_ID, ZOOMINFO_PRIVATE_KEY);
    console.log('Successfully obtained access token:');
    console.log(token);
    // You can now use this token for subsequent Zoominfo API calls
    return token;
  } catch (error) {
    console.error('Failed to get access token:', error.message);
    // Log detailed error or handle specific Zoominfo API error codes here
    if (error.response && error.response.data) {
      console.error('API Error Details:', error.response.data);
    }
    process.exit(1);
  }
}

authenticateAndGetToken();