Skip to content
Node.js SDK for FullContact Contacts API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Updated scope requires in jsdocs Mar 13, 2018
.gitignore Added in support for user-agent and custom api url. Aug 21, 2017
.istanbul.yml Added in istanbul config to generate cobertura report. Feb 15, 2017
.travis.yml Added in slack notifications Dec 12, 2017
LICENSE Added in License Dec 12, 2017 Updated README Dec 12, 2017 Updated dependencies. Jan 15, 2019
package-lock.json Updated dev depenencies Jan 15, 2019
package.json Bumped version Jan 15, 2019

Build Status npm version Node version

IMPORTANT: This SDK should be used server-side only. Using it in a browser would expose Client Secret or API Key.


npm install contacts-api-node --save


API Documentation can be found at

JSDocs can be found in



var fullcontact = require('contacts-api-node')({
	apiKey: '<API Key>', //for v2 APIs. See:
	clientId: '<Client ID>', //for v3 APIs. See:
	clientSecret: '<Client Secret>',
	redirectUri: '<Redirect URI>',
	scope: 'list,of,scopes',
	userAgent: '<AppName/Version>',
	baseUrl: '<URL>' //to override base api url

All OAuth methods can be found under the oauth property on the client.

Supported Methods:
  • getAuthorizationUrl()
  • exchangeAuthCode(code)
  • exchangeRefreshToken(refresh_token)
var url = fullcontact.oauth.getAuthorizationUrl();
v2 APIs

All v2 APIs can be found under the v2 property on the client.

	email: ''
	.then(res => {
		//2xx response
	.catch(res => {
		//non-2xx response
Contacts APIs

All Contacts APIs can be found under the contacts property on the client.

	.then(res => {
		//2xx response
	.catch(res => {
		//non-2xx response


To run tests:

npm test

To get coverage report:

npm run coverage

You can’t perform that action at this time.