Pipedrive API
Browse all Pipedrive APIs✓ Official Vendor SpecCRMDeal PipelineapiKey35 EndpointsREST
For Agents
Create and move deals through pipeline stages, manage person and organization contacts, log sales activities, and track leads in Pipedrive CRM. Supports 35 endpoints covering the full sales lifecycle.
Use for: I need to create a new deal in Pipedrive with a specific value and pipeline stage, Find all deals in the 'Negotiation' stage of my sales pipeline, I want to add a new person contact with email and phone number, Log a completed phone call activity against an existing deal
Not supported: Does not handle email marketing, marketing automation, customer support tickets, or accounting — use for sales pipeline and contact management only.
Track sales deals through customizable pipeline stages, manage person and organization contacts, log activities, and automate sales workflows in Pipedrive's activity-based CRM. The API provides full access to deals, persons, organizations, activities, leads, products, notes, files, webhooks, and custom fields — enabling programmatic control over the entire sales process from lead capture to deal closure.
Install Jentic One Beta
Connect the Pipedrive API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pipedrive API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Pipedrive API.
Move deals through custom pipeline stages and track win/loss outcomes with monetary values
Log calls, emails, meetings, and tasks as activities linked to deals or contacts
Search and filter persons and organizations by custom fields and relationship data
Capture and qualify leads before converting them to deals in the pipeline
Attach products with pricing to deals for revenue forecasting and line-item tracking
Register webhooks to receive real-time notifications when deals, persons, or activities change
Upload and attach files to deals, persons, or organizations for document management
Use Cases
Patterns agents use Pipedrive API for, with concrete tasks.
★ AI Agent Sales Pipeline Automation
AI agents use Pipedrive through Jentic to automate deal progression, activity logging, and contact enrichment without manual CRM data entry. An agent discovers deal and activity endpoints via Jentic's intent search, creates deals from inbound leads, logs follow-up activities, and moves deals through stages based on customer interactions — all programmatically and in real time.
Create a new deal titled 'Enterprise License - Acme Corp' with value $50,000 in the 'Qualified' stage, then log a 'call' activity noting the initial discovery call was completed
Deal Pipeline Reporting and Forecasting
Pull deal data across all pipeline stages to build real-time sales forecasts, conversion rate analyses, and revenue projections. The API returns deal values, stage positions, expected close dates, and win probabilities. Combined with the pipelines and stages endpoints, agents can map the full pipeline structure and calculate stage-by-stage conversion metrics.
Retrieve all deals from the default pipeline, group them by stage, and calculate total weighted value per stage using deal values and stage probabilities
Contact and Organization Management
Synchronize person and organization records between Pipedrive and external systems such as marketing platforms, support tools, or data enrichment services. The API supports creating, updating, and searching contacts by email, phone, name, or custom fields. Organization records link multiple persons to a single company entity for account-based selling.
Search for a person by email address 'john@acme.com', and if found, update their phone number and link them to the organization 'Acme Corp'
Lead Capture and Qualification
Ingest leads from web forms, chatbots, or partner referrals into Pipedrive's lead inbox for qualification before pipeline entry. Leads sit in a separate inbox until qualified and converted to deals, preventing unvetted entries from polluting pipeline metrics. The API supports creating leads with title, value, labels, and associated person or organization.
Create a new lead titled 'Inbound Demo Request - Beta Corp' with expected value $25,000 and associate it with a newly created person contact
Key Endpoints
35 endpoints — track sales deals through customizable pipeline stages, manage person and organization contacts, log activities, and automate sales workflows in pipedrive's activity-based crm.
METHOD
PATH
DESCRIPTION
POST
/api/v1/deals
Create a new deal in a pipeline stage
GET
/api/v1/deals
List all deals with filtering
PUT
/api/v1/deals/{id}
Update a deal's stage, value, or properties
POST
/api/v1/persons
Create a new person contact
POST
/api/v1/activities
Log a sales activity
POST
/api/v1/leads
Create a new lead
POST
/api/v1/webhooks
Register a webhook for event notifications
GET
/api/v1/pipelines
List all sales pipelines
POST
/api/v1/deals
Create a new deal in a pipeline stage
GET
/api/v1/deals
List all deals with filtering
PUT
/api/v1/deals/{id}
Update a deal's stage, value, or properties
POST
/api/v1/persons
Create a new person contact
POST
/api/v1/activities
Log a sales activity
POST
/api/v1/leads
Create a new lead
POST
/api/v1/webhooks
Register a webhook for event notifications
GET
/api/v1/pipelines
List all sales pipelines
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Pipedrive API tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive authenticated API calls — raw api_token values never appear in the agent's context or query parameters.
Intent-based discovery
Agents search by intent (e.g., 'create a deal in Pipedrive') and Jentic returns matching Pipedrive operations with their input schemas, including required fields like title, value, and stage_id.
Time to first call
Direct Pipedrive integration: 1-3 days for authentication setup, pipeline/stage discovery, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Pipedrive API through Jentic.
What authentication does the Pipedrive API use?
The API uses an API token passed as the 'api_token' query parameter on every request. Each Pipedrive user has a unique API token found in Settings > Personal preferences > API. Through Jentic, API tokens are stored encrypted in the MAXsystem vault and agents receive authenticated requests without the raw token appearing in their context.
Can I move a deal to a different pipeline stage via the API?
Yes. Use PUT /api/v1/deals/{id} with the 'stage_id' parameter set to the target stage. You can retrieve available stages and their IDs from GET /api/v1/stages. Each stage belongs to a pipeline, and deals can only be moved to stages within their current pipeline unless you also update the pipeline_id.
What are the rate limits for the Pipedrive API?
Pipedrive applies rate limits per API token: 80 requests per 2 seconds for most endpoints on standard plans, with higher limits on Advanced and Enterprise tiers. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response for monitoring usage.
How do I create a deal through Jentic for an AI agent?
Install the SDK with pip install jentic, then search for 'create a deal in Pipedrive'. Jentic returns the POST /api/v1/deals operation with its input schema including title, value, currency, stage_id, and person_id fields. Load the schema and execute — the api_token authentication is handled automatically by the MAXsystem vault.
Can I log different types of activities against deals?
Yes. POST /api/v1/activities creates activities of types including call, meeting, task, email, and lunch. Each activity requires a type, subject, and can be linked to a deal_id, person_id, or org_id. You can mark activities as done (done: 1) or schedule them for future dates with due_date and due_time fields.
Does Pipedrive support webhooks for real-time notifications?
Yes. POST /api/v1/webhooks registers a callback URL that receives HTTP POST notifications when specified events occur. Supported events include deal creation, deal stage changes, person updates, activity completion, and more. Each webhook receives a JSON payload with the full object data and the event type.
Is the Pipedrive API free to use?
API access is included with all paid Pipedrive plans (Essential, Advanced, Professional, Enterprise) starting at $14/user/month. There is no separate API fee, but rate limits increase with higher plan tiers. The free trial includes API access for evaluation.
GET STARTED