| name | pipedrive-api |
| description | Use Pipedrive REST API v1 from an integration. Use when reading or writing deals, persons, organizations, leads, or activities. |
| allowed-tools | ["Read","Edit","Bash"] |
Using the Pipedrive API
Overview
The Pipedrive REST API v1 base URL is https://api.pipedrive.com/v1. It is stateless and returns JSON. Full reference: https://developers.pipedrive.com/docs/api/v1
Authentication in this project
This project uses OAuth 2.0. After a user authorises your app, the access token is stored in the database (pipedrive_tokens table). The generated src/pipedrive/ module handles token retrieval and client initialisation:
import { getClient } from './pipedrive/client.js';
const client = await getClient(companyId);
Use client to call the official Pipedrive Node.js SDK (pipedrive npm package), which maps directly to the REST API.
Main resource categories
Common resources include Deals, Persons, Organizations, Activities, Notes, Leads, Pipelines, Stages, Products, Goals, Webhooks, Users, Roles, and Permission Sets.
Common usage patterns
List deals:
const deals = await client.deals.getDeals({ limit: 50 });
Get a person:
const person = await client.persons.getPerson({ id: personId });
Create an activity:
await client.activities.addActivity({
subject: 'Follow-up call',
type: 'call',
due_date: '2026-06-01',
});
Adding a new API call
- Read
src/pipedrive/ to understand the existing wrapper pattern
- Use
client.<resource>.<method>() following the SDK method names
- Handle token expiry — the client wrapper in this project manages token refresh automatically
Rate limits and pagination
- Rate limits apply per API token / OAuth token — check response headers for
X-RateLimit-* values
- Paginate large result sets using the
start and limit query parameters
- The SDK returns a
data array and additional_data.pagination object for paginated resources
Further reading
