Pipedrive

BUSINESS · CRM & SUPPORT

Deals, pipelines, contacts, and activities in that rep’s own CRM.

Connecting Pipedrive in practice

Pipedrive meters a daily token budget rather than a request count: 30,000 base tokens times a plan multiplier (Lite 1x through Ultimate 7x) times the number of seats, where a single read costs 2 tokens, a list 20 and a search 40. Run it dry and every call is 429 until the next day’s reset, which makes exhaustion a whole-day outage rather than a pause.

Scopes that draw scrutiny

admin Administers pipelines, stages, fields, activity types, users, webhooks and permissions. Pipedrive requires the installing user to have admin rights within the company.
mail:full Read, update and delete mail threads, so the agent reaches the mailbox contents synced into the CRM rather than only CRM records.
users:read Reads user data, permissions, roles and team information — effectively the company’s org chart and who can see what.
search:read Searches across the whole account for deals, leads, products, persons, organizations, projects and files, so it is the widest read available in one scope.
deals:full Create, read, update and delete deals with their participants, followers, notes and files, which is the revenue record of the business.

Rate limits

Daily budget: 30,000 tokens × plan multiplier (Lite 1, Growth 2, Premium 5, Ultimate 7) × number of seats, plus any purchased top-ups.
Token cost per call: get single entity 2, get list 20, update 10, delete single 6, delete list 10, search 40. API v2 endpoints cost less than the v1 equivalents.
Burst limit per 2 seconds with an API token: Lite 20, Growth 40, Premium 100, Ultimate 120.
Burst limit per 2 seconds for OAuth apps: Lite 80, Growth 160, Premium 400, Ultimate 480.
Search API: 10 requests per 2 seconds on all plans.

Who has to approve

The admin scope requires the user installing the app to have admin rights within the company. Pipedrive notes that a non-admin can only work with an app needing that scope if an administrator installed it first and created the custom fields, activity types or pipelines it depends on.

Worth knowing

Notifications are sent at 75% and 100% of the daily budget, so the only warning before a day-long 429 is an email to the account, not a header on your call.
Because the budget multiplies by seats, the same integration has a very different ceiling in two companies on the same plan — a one-seat Premium account is smaller than a ten-seat Lite one.
A search costs 40 tokens and is separately capped at 10 requests per 2 seconds, so a search-driven agent hits two unrelated walls.
Moving from v1 to v2 endpoints buys throughput rather than features, since the v2 calls are documented as costing fewer tokens.

Checked against Rate limiting (2026-09-29), Scopes and permissions explanations (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

pipedrive_delete_activities_by_idWRITE

Delete activity via DELETE /activities/{id}

activities:full

pipedrive_delete_boards_by_idWRITE

Delete project board via DELETE /boards/{id}

projects:full

pipedrive_delete_dealfields_by_field_codeWRITE

Delete deal field via DELETE /dealFields/{field_code}

admindeal-fields:full

pipedrive_delete_dealfields_by_field_code_optionsWRITE

Delete deal field options via DELETE /dealFields/{field_code}/options

admindeal-fields:fulldeals:full

pipedrive_delete_deals_by_idWRITE

Delete deal via DELETE /deals/{id}

deals:full

pipedrive_delete_deals_by_id_discounts_by_discount_idWRITE

Delete additional discount via DELETE /deals/{id}/discounts/{discount_id}

deals:full

pipedrive_delete_deals_by_id_followers_by_follower_idWRITE

Delete deal follower via DELETE /deals/{id}/followers/{follower_id}

deals:full

pipedrive_delete_deals_by_id_installments_by_installment_idWRITE

Delete installment via DELETE /deals/{id}/installments/{installment_id}

deals:full

pipedrive_delete_deals_by_id_productsWRITE

Delete many deal products via DELETE /deals/{id}/products

deals:fullproducts:full

pipedrive_delete_deals_by_id_products_by_product_attachment_idWRITE

Delete deal product via DELETE /deals/{id}/products/{product_attachment_id}

deals:fullproducts:full

pipedrive_delete_organizationfields_by_field_codeWRITE

Delete organization field via DELETE /organizationFields/{field_code}

admincontact-fields:full

pipedrive_delete_organizationfields_by_field_code_optionsWRITE

Delete organization field options via DELETE /organizationFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_delete_organizations_by_idWRITE

Delete organization via DELETE /organizations/{id}

contacts:full

pipedrive_delete_organizations_by_id_followers_by_follower_idWRITE

Delete organization follower via DELETE /organizations/{id}/followers/{follower_id}

contacts:full

pipedrive_delete_personfields_by_field_codeWRITE

Delete person field via DELETE /personFields/{field_code}

admincontact-fields:full

pipedrive_delete_personfields_by_field_code_optionsWRITE

Delete person field options via DELETE /personFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_delete_persons_by_idWRITE

Delete person via DELETE /persons/{id}

contacts:full

pipedrive_delete_persons_by_id_followers_by_follower_idWRITE

Delete person follower via DELETE /persons/{id}/followers/{follower_id}

contacts:full

pipedrive_delete_phases_by_idWRITE

Delete project phase via DELETE /phases/{id}

projects:full

pipedrive_delete_pipelines_by_idWRITE

Delete pipeline via DELETE /pipelines/{id}

admin

pipedrive_delete_productfields_by_field_codeWRITE

Delete product field via DELETE /productFields/{field_code}

product-fields:fullproducts:full

pipedrive_delete_productfields_by_field_code_optionsWRITE

Delete product field options via DELETE /productFields/{field_code}/options

product-fields:fullproducts:full

pipedrive_delete_products_by_idWRITE

Delete product via DELETE /products/{id}

products:full

pipedrive_delete_products_by_id_followers_by_follower_idWRITE

Delete product follower via DELETE /products/{id}/followers/{follower_id}

products:full

pipedrive_delete_products_by_id_imagesWRITE

Delete product image via DELETE /products/{id}/images

products:full

pipedrive_delete_products_by_id_variations_by_product_variation_idWRITE

Delete product variation via DELETE /products/{id}/variations/{product_variation_id}

products:full

pipedrive_delete_projectfields_by_field_codeWRITE

Delete project field via DELETE /projectFields/{field_code}

project-fields:full

pipedrive_delete_projectfields_by_field_code_optionsWRITE

Delete project field options via DELETE /projectFields/{field_code}/options

project-fields:full

pipedrive_delete_projects_by_idWRITE

Delete project via DELETE /projects/{id}

projects:full

pipedrive_delete_stages_by_idWRITE

Delete stage via DELETE /stages/{id}

admin

pipedrive_delete_tasks_by_idWRITE

Delete task via DELETE /tasks/{id}

projects:full

pipedrive_get_activitiesREAD

Get activities via GET /activities

activities:full

pipedrive_get_activities_by_idREAD

Get activity via GET /activities/{id}

activities:full

pipedrive_get_activityfieldsREAD

Get activity fields via GET /activityFields

admin

pipedrive_get_activityfields_by_field_codeREAD

Get activity field via GET /activityFields/{field_code}

admin

pipedrive_get_boardsREAD

Get projects boards via GET /boards

projects:full

pipedrive_get_boards_by_idREAD

Get projects board via GET /boards/{id}

projects:full

pipedrive_get_dealfieldsREAD

Get deal fields via GET /dealFields

admindeal-fields:fulldeals:full

pipedrive_get_dealfields_by_field_codeREAD

Get deal field via GET /dealFields/{field_code}

admindeal-fields:fulldeals:full

pipedrive_get_dealsREAD

Get deals via GET /deals

deals:full

pipedrive_get_deals_archivedREAD

Get archived deals via GET /deals/archived

deals:full

pipedrive_get_deals_by_idREAD

Get deal via GET /deals/{id}

deals:full

pipedrive_get_deals_by_id_convert_status_by_conversion_idREAD

Get deal conversion status via GET /deals/{id}/convert/status/{conversion_id}

deals:full

pipedrive_get_deals_by_id_discountsREAD

Get additional discounts via GET /deals/{id}/discounts

deals:full

pipedrive_get_deals_by_id_followersREAD

Get deal followers via GET /deals/{id}/followers

deals:full

pipedrive_get_deals_by_id_followers_changelogREAD

Get deal followers changelog via GET /deals/{id}/followers/changelog

deals:full

pipedrive_get_deals_by_id_productsREAD

Get deal products via GET /deals/{id}/products

deals:fullproducts:full

pipedrive_get_deals_installmentsREAD

Get installments via GET /deals/installments

deals:full

pipedrive_get_deals_productsREAD

Get deals products via GET /deals/products

deals:fullproducts:full

pipedrive_get_deals_searchREAD

Search deals via GET /deals/search

deals:fullsearch:read

pipedrive_get_itemsearchREAD

Search item via GET /itemSearch

search:read

pipedrive_get_itemsearch_fieldREAD

Search item by field via GET /itemSearch/field

search:read

pipedrive_get_leads_by_id_convert_status_by_conversion_idREAD

Get lead conversion status via GET /leads/{id}/convert/status/{conversion_id}

leads:full

pipedrive_get_leads_searchREAD

Search leads via GET /leads/search

leads:fullsearch:read

pipedrive_get_organizationfieldsREAD

Get organization fields via GET /organizationFields

admincontact-fields:fullcontacts:full

pipedrive_get_organizationfields_by_field_codeREAD

Get organization field via GET /organizationFields/{field_code}

admincontact-fields:fullcontacts:full

pipedrive_get_organizationsREAD

Get organizations via GET /organizations

contacts:full

pipedrive_get_organizations_by_idREAD

Get organization via GET /organizations/{id}

contacts:full

pipedrive_get_organizations_by_id_followersREAD

Get organization followers via GET /organizations/{id}/followers

contacts:full

pipedrive_get_organizations_by_id_followers_changelogREAD

Get organization followers changelog via GET /organizations/{id}/followers/changelog

contacts:full

pipedrive_get_organizations_searchREAD

Search organization via GET /organizations/search

contacts:fullsearch:read

pipedrive_get_personfieldsREAD

Get person fields via GET /personFields

admincontact-fields:fullcontacts:full

pipedrive_get_personfields_by_field_codeREAD

Get person field via GET /personFields/{field_code}

admincontact-fields:fullcontacts:full

pipedrive_get_personsREAD

Get persons via GET /persons

contacts:full

pipedrive_get_persons_by_idREAD

Get person via GET /persons/{id}

contacts:full

pipedrive_get_persons_by_id_followersREAD

Get person followers via GET /persons/{id}/followers

contacts:full

pipedrive_get_persons_by_id_followers_changelogREAD

Get person followers changelog via GET /persons/{id}/followers/changelog

contacts:full

pipedrive_get_persons_by_id_pictureREAD

Get person picture via GET /persons/{id}/picture

contacts:full

pipedrive_get_persons_searchREAD

Search persons via GET /persons/search

contacts:fullsearch:read

pipedrive_get_phasesREAD

Get projects phases via GET /phases

projects:full

pipedrive_get_phases_by_idREAD

Get projects phase via GET /phases/{id}

projects:full

pipedrive_get_pipelinesREAD

Get pipelines via GET /pipelines

admindeals:full

pipedrive_get_pipelines_by_idREAD

Get pipeline via GET /pipelines/{id}

admindeals:full

pipedrive_get_productfieldsREAD

Get product fields via GET /productFields

product-fields:fullproducts:full

pipedrive_get_productfields_by_field_codeREAD

Get product field via GET /productFields/{field_code}

product-fields:fullproducts:full

pipedrive_get_productsREAD

Get products via GET /products

products:full

pipedrive_get_products_by_idREAD

Get product via GET /products/{id}

products:full

pipedrive_get_products_by_id_followersREAD

Get product followers via GET /products/{id}/followers

products:full

pipedrive_get_products_by_id_followers_changelogREAD

Get product followers changelog via GET /products/{id}/followers/changelog

products:full

pipedrive_get_products_by_id_imagesREAD

Get product image via GET /products/{id}/images

products:full

pipedrive_get_products_by_id_variationsREAD

Get product variations via GET /products/{id}/variations

products:full

pipedrive_get_products_searchREAD

Search products via GET /products/search

products:fullsearch:read

pipedrive_get_projectfieldsREAD

Get project fields via GET /projectFields

project-fields:fullprojects:full

pipedrive_get_projectfields_by_field_codeREAD

Get project field via GET /projectFields/{field_code}

project-fields:fullprojects:full

pipedrive_get_projectsREAD

Get projects via GET /projects

projects:full

pipedrive_get_projects_archivedREAD

Get archived projects via GET /projects/archived

projects:full

pipedrive_get_projects_by_idREAD

Get project via GET /projects/{id}

projects:full

pipedrive_get_projects_by_id_changelogREAD

Get project changelog via GET /projects/{id}/changelog

projects:full

pipedrive_get_projects_by_id_permittedusersREAD

Get project users via GET /projects/{id}/permittedUsers

projects:full

pipedrive_get_projects_searchREAD

Search projects via GET /projects/search

projects:fullsearch:read

pipedrive_get_projecttemplatesREAD

Get project templates via GET /projectTemplates

projects:full

pipedrive_get_projecttemplates_by_idREAD

Get project template via GET /projectTemplates/{id}

projects:full

pipedrive_get_stagesREAD

Get stages via GET /stages

admindeals:full

pipedrive_get_stages_by_idREAD

Get stage via GET /stages/{id}

admindeals:full

pipedrive_get_tasksREAD

Get tasks via GET /tasks

projects:full

pipedrive_get_tasks_by_idREAD

Get task via GET /tasks/{id}

projects:full

pipedrive_get_users_by_id_followersREAD

Get user followers via GET /users/{id}/followers

users:read

pipedrive_patch_activities_by_idWRITE

Update activity via PATCH /activities/{id}

activities:full

pipedrive_patch_boards_by_idWRITE

Update project board via PATCH /boards/{id}

projects:full

pipedrive_patch_dealfields_by_field_codeWRITE

Update deal field via PATCH /dealFields/{field_code}

admindeal-fields:fulldeals:full

pipedrive_patch_dealfields_by_field_code_optionsWRITE

Update deal field options via PATCH /dealFields/{field_code}/options

admindeal-fields:fulldeals:full

pipedrive_patch_deals_by_idWRITE

Update deal via PATCH /deals/{id}

deals:full

pipedrive_patch_deals_by_id_discounts_by_discount_idWRITE

Update additional discount via PATCH /deals/{id}/discounts/{discount_id}

deals:full

pipedrive_patch_deals_by_id_installments_by_installment_idWRITE

Update installment via PATCH /deals/{id}/installments/{installment_id}

deals:full

pipedrive_patch_deals_by_id_products_by_product_attachment_idWRITE

Update deal product via PATCH /deals/{id}/products/{product_attachment_id}

deals:fullproducts:full

pipedrive_patch_organizationfields_by_field_codeWRITE

Update organization field via PATCH /organizationFields/{field_code}

admincontact-fields:fullcontacts:full

pipedrive_patch_organizationfields_by_field_code_optionsWRITE

Update organization field options via PATCH /organizationFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_patch_organizations_by_idWRITE

Update organization via PATCH /organizations/{id}

contacts:full

pipedrive_patch_personfields_by_field_codeWRITE

Update person field via PATCH /personFields/{field_code}

admincontact-fields:fullcontacts:full

pipedrive_patch_personfields_by_field_code_optionsWRITE

Update person field options via PATCH /personFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_patch_persons_by_idWRITE

Update person via PATCH /persons/{id}

contacts:full

pipedrive_patch_phases_by_idWRITE

Update project phase via PATCH /phases/{id}

projects:full

pipedrive_patch_pipelines_by_idWRITE

Update pipeline via PATCH /pipelines/{id}

admin

pipedrive_patch_productfields_by_field_codeWRITE

Update product field via PATCH /productFields/{field_code}

product-fields:fullproducts:full

pipedrive_patch_productfields_by_field_code_optionsWRITE

Update product field options via PATCH /productFields/{field_code}/options

product-fields:fullproducts:full

pipedrive_patch_products_by_idWRITE

Update product via PATCH /products/{id}

products:full

pipedrive_patch_products_by_id_variations_by_product_variation_idWRITE

Update product variation via PATCH /products/{id}/variations/{product_variation_id}

products:full

pipedrive_patch_projectfields_by_field_codeWRITE

Update project field via PATCH /projectFields/{field_code}

project-fields:full

pipedrive_patch_projectfields_by_field_code_optionsWRITE

Update project field options via PATCH /projectFields/{field_code}/options

project-fields:full

pipedrive_patch_projects_by_idWRITE

Update project via PATCH /projects/{id}

projects:full

pipedrive_patch_stages_by_idWRITE

Update stage via PATCH /stages/{id}

admin

pipedrive_patch_tasks_by_idWRITE

Update task via PATCH /tasks/{id}

projects:full

pipedrive_post_activitiesWRITE

Add activity via POST /activities

activities:full

pipedrive_post_boardsWRITE

Add project board via POST /boards

projects:full

pipedrive_post_dealfieldsWRITE

Add deal field via POST /dealFields

admindeal-fields:full

pipedrive_post_dealfields_by_field_code_optionsWRITE

Add deal field options via POST /dealFields/{field_code}/options

admindeal-fields:fulldeals:full

pipedrive_post_dealsWRITE

Add deal via POST /deals

deals:full

pipedrive_post_deals_by_id_convert_leadWRITE

Convert deal to lead via POST /deals/{id}/convert/lead

deals:full

pipedrive_post_deals_by_id_discountsWRITE

Post additional discount via POST /deals/{id}/discounts

deals:full

pipedrive_post_deals_by_id_followersWRITE

Add deal follower via POST /deals/{id}/followers

deals:full

pipedrive_post_deals_by_id_installmentsWRITE

Post installment via POST /deals/{id}/installments

deals:full

pipedrive_post_deals_by_id_productsWRITE

Add deal product via POST /deals/{id}/products

deals:fullproducts:full

pipedrive_post_deals_by_id_products_bulkWRITE

Add many deal products via POST /deals/{id}/products/bulk

deals:fullproducts:full

pipedrive_post_leads_by_id_convert_dealWRITE

Convert lead to deal via POST /leads/{id}/convert/deal

leads:full

pipedrive_post_organizationfieldsWRITE

Add organization field via POST /organizationFields

admincontact-fields:full

pipedrive_post_organizationfields_by_field_code_optionsWRITE

Add organization field options via POST /organizationFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_post_organizationsWRITE

Add organization via POST /organizations

contacts:full

pipedrive_post_organizations_by_id_followersWRITE

Add organization follower via POST /organizations/{id}/followers

contacts:full

pipedrive_post_personfieldsWRITE

Add person field via POST /personFields

admincontact-fields:full

pipedrive_post_personfields_by_field_code_optionsWRITE

Add person field options via POST /personFields/{field_code}/options

admincontact-fields:fullcontacts:full

pipedrive_post_personsWRITE

Add person via POST /persons

contacts:full

pipedrive_post_persons_by_id_followersWRITE

Add person follower via POST /persons/{id}/followers

contacts:full

pipedrive_post_phasesWRITE

Add project phase via POST /phases

projects:full

pipedrive_post_pipelinesWRITE

Add pipeline via POST /pipelines

admin

pipedrive_post_productfieldsWRITE

Add product field via POST /productFields

product-fields:fullproducts:full

pipedrive_post_productfields_by_field_code_optionsWRITE

Add product field options via POST /productFields/{field_code}/options

product-fields:fullproducts:full

pipedrive_post_productsWRITE

Add product via POST /products

products:full

pipedrive_post_products_by_id_duplicateWRITE

Duplicate product via POST /products/{id}/duplicate

products:full

pipedrive_post_products_by_id_followersWRITE

Add product follower via POST /products/{id}/followers

products:full

pipedrive_post_products_by_id_variationsWRITE

Add product variation via POST /products/{id}/variations

products:full

pipedrive_post_projectfieldsWRITE

Add project field via POST /projectFields

project-fields:full

pipedrive_post_projectfields_by_field_code_optionsWRITE

Add project field options via POST /projectFields/{field_code}/options

project-fields:full

pipedrive_post_projectsWRITE

Add project via POST /projects

projects:full

pipedrive_post_projects_by_id_archiveWRITE

Archive project via POST /projects/{id}/archive

projects:full

pipedrive_post_stagesWRITE

Add stage via POST /stages

admin

pipedrive_post_tasksWRITE

Add task via POST /tasks

projects:full

Often connected alongside

Put Pipedrive behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.

Get a demo See pricing