菜单
Guide developers on using the Pipedrive REST API v1 within their integration project. Use when a developer wants to query or mutate Pipedrive data (deals, persons, organizations, leads, activities, etc.) from their app.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/pipedrive/create-pipedrive-app --skill pipedrive-api命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Add a custom panel or custom modal App Extension to an existing Pipedrive integration project. Use when the developer wants to add an iframe-based UI extension to their app.
Scaffold a new Pipedrive Marketplace integration project with OAuth, database, and optional App Extensions. Use when the developer wants to start a new Pipedrive app from scratch.
Review a Pipedrive Marketplace integration project for readiness. Checks the project for missing requirements and reports only what needs to be fixed before submission.
| name | pipedrive-api |
| description | Guide developers on using the Pipedrive REST API v1 within their integration project. Use when a developer wants to query or mutate Pipedrive data (deals, persons, organizations, leads, activities, etc.) from their app. |
| allowed-tools | ["Read","Edit","Bash"] |
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
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.
| Category | Resources |
|---|---|
| CRM core | Deals, Persons, Organizations, Activities, Notes |
| Lead management | Leads, Lead Fields, Lead Labels |
| Sales | Pipelines, Stages, Products, Goals |
| Communication | Webhooks, Call Logs, Mailbox |
| Admin | Users, Roles, Permission Sets |
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',
});
src/pipedrive/ to understand the existing wrapper patternclient.<resource>.<method>() following the SDK method namesX-RateLimit-* valuesstart and limit query parametersdata array and additional_data.pagination object for paginated resources