{"id":48917,"library":"pipedrive","title":"Pipedrive API Client for Node.js","description":"Official Node.js SDK for Pipedrive CRM REST API, supporting both API v1 and v2 endpoints. Current stable version is 33.4.2, with monthly releases. Includes full TypeScript definitions. Key differentiators: first-party library maintained by Pipedrive, supports OAuth2 and API token auth, generated from OpenAPI spec. Use for server-side integration with Pipedrive CRM for deals, persons, organizations, products, etc.","status":"active","version":"33.4.2","language":"javascript","source_language":"en","source_url":"https://github.com/pipedrive/client-nodejs","tags":["javascript","typescript"],"install":[{"cmd":"npm install pipedrive","lang":"bash","label":"npm"},{"cmd":"yarn add pipedrive","lang":"bash","label":"yarn"},{"cmd":"pnpm add pipedrive","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"HTTP client used internally by all API classes","package":"axios","optional":false}],"imports":[{"note":"ESM-only package since v30. Use dynamic import for CommonJS.","wrong":"const { Configuration } = require('pipedrive')","symbol":"Configuration","correct":"import { Configuration } from 'pipedrive'"},{"note":"API v2 endpoints are under 'pipedrive/v2' subpath. Use 'pipedrive/v1' for v1.","wrong":"import { DealsApi } from 'pipedrive'","symbol":"DealsApi","correct":"import { DealsApi } from 'pipedrive/v2'"},{"note":"OAuth2 helpers are per-version. For v1 use 'pipedrive/v1'.","wrong":"import { OAuth2Configuration } from 'pipedrive'","symbol":"OAuth2Configuration","correct":"import { OAuth2Configuration } from 'pipedrive/v2'"}],"quickstart":{"code":"import { Configuration, DealsApi } from 'pipedrive/v2';\n\nconst config = new Configuration({\n  apiKey: process.env.PIPEDRIVE_API_KEY ?? ''\n});\n\nasync function main() {\n  const api = new DealsApi(config);\n  const { data } = await api.getDeals({ limit: 10 });\n  console.log(data);\n}\n\nmain().catch(console.error);","lang":"typescript","description":"Show how to initialize the client with an API token and fetch a list of deals using API v2."},"warnings":[{"fix":"Use dynamic import: const pipedrive = await import('pipedrive');","message":"Package is ESM-only since v30. CommonJS require() will fail.","severity":"breaking","affected_versions":">=30.0.0"},{"fix":"Use 'pipedrive/v1' for v1 endpoints, 'pipedrive/v2' for v2 endpoints.","message":"API v1 and v2 have separate namespaces. Mixing imports from wrong subpath may cause runtime errors.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Migrate to API v2 endpoints under 'pipedrive/v2'.","message":"API v1 is deprecated and will be removed in a future version in favor of v2.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Set only one authentication method to avoid unexpected authorization.","message":"If both apiKey and accessToken are set, apiKey takes precedence.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'33.4.2':25 'api':2,13,16,45 'auth':47 'client':3 'crm':11,60 'current':21 'deal':62 'definit':32 'differenti':34 'endpoint':20 'etc':66 'first':36 'first-parti':35 'full':30 'generat':48 'includ':29 'integr':57 'javascript':67 'key':33 'librari':38 'maintain':39 'month':27 'node.js':5,7 'oauth2':43 'offici':6 'openapi':50 'organ':64 'parti':37 'person':63 'pipedr':1,10,41,59 'product':65 'releas':28 'rest':12 'sdk':8 'server':55 'server-sid':54 'side':56 'spec':51 'stabl':22 'support':14,42 'token':46 'typescript':31,68 'use':52 'v1':17 'v2':19 'version':23","created_at":"2026-06-07T16:59:07.841413+00:00","updated_at":"2026-06-07T16:59:07.841413+00:00","problems":[{"fix":"Run 'npm install pipedrive' and ensure tsconfig includes 'node_modules'.","cause":"Missing npm install or TypeScript not resolving types (package ships .d.ts).","error":"Cannot find module 'pipedrive' or its corresponding type declarations."},{"fix":"Use dynamic import: const { Configuration } = await import('pipedrive');","cause":"CommonJS require() on ESM-only package.","error":"TypeError: pipedrive.Configuration is not a constructor"},{"fix":"Update to latest version and use correct import: 'pipedrive/v2'.","cause":"Using wrong subpath or outdated package version (<30).","error":"Configuration is not exported from 'pipedrive/v2'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://developers.pipedrive.com","github":"https://github.com/pipedrive/client-nodejs","docs":null,"changelog":null,"pypi":null,"npm":"pipedrive","openapi_spec":null,"status_page":null,"smithery":null,"categories":["crm"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}