pipedrive

name	pipedrive
description	Pipedrive CRM API for managing deals, contacts (persons), organizations, activities, leads, pipelines, products, and notes. Use for sales pipeline management, deal tracking, contact/organization management, activity scheduling, lead handling, or any Pipedrive CRM tasks.

Pipedrive

Sales CRM API for deals, contacts, organizations, activities, pipelines, leads, and notes.

Setup

Get your API token from Pipedrive:

1. Go to Settings → Personal preferences → API
2. Copy your personal API token

Store in ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "pipedrive": {
        "apiToken": "YOUR_API_TOKEN"
      }
    }
  }
}

Or set env: PIPEDRIVE_API_TOKEN=xxx

Quick Reference

Deals (most important!)

{baseDir}/scripts/pipedrive.sh deals list                    # List all deals
{baseDir}/scripts/pipedrive.sh deals list --status open      # Open deals only
{baseDir}/scripts/pipedrive.sh deals search "query"          # Search deals
{baseDir}/scripts/pipedrive.sh deals show <id>               # Get deal details
{baseDir}/scripts/pipedrive.sh deals create --title "Deal" --person <id> --value 1000
{baseDir}/scripts/pipedrive.sh deals update <id> --value 2000 --stage <stage_id>
{baseDir}/scripts/pipedrive.sh deals won <id>                # Mark deal as won
{baseDir}/scripts/pipedrive.sh deals lost <id> --reason "Reason"  # Mark deal as lost
{baseDir}/scripts/pipedrive.sh deals delete <id>             # Delete deal

Persons (contacts)

{baseDir}/scripts/pipedrive.sh persons list                  # List all persons
{baseDir}/scripts/pipedrive.sh persons search "query"        # Search persons
{baseDir}/scripts/pipedrive.sh persons show <id>             # Get person details
{baseDir}/scripts/pipedrive.sh persons create --name "John Doe" --email "[e-mail]"
{baseDir}/scripts/pipedrive.sh persons update <id> --phone "[phone]"
{baseDir}/scripts/pipedrive.sh persons delete <id>           # Delete person

Organizations

{baseDir}/scripts/pipedrive.sh orgs list                     # List all organizations
{baseDir}/scripts/pipedrive.sh orgs search "query"           # Search organizations
{baseDir}/scripts/pipedrive.sh orgs show <id>                # Get organization details
{baseDir}/scripts/pipedrive.sh orgs create --name "Acme Corp"
{baseDir}/scripts/pipedrive.sh orgs update <id> --address "123 Main St"
{baseDir}/scripts/pipedrive.sh orgs delete <id>              # Delete organization

Activities

{baseDir}/scripts/pipedrive.sh activities list               # List activities
{baseDir}/scripts/pipedrive.sh activities list --done 0      # Upcoming activities
{baseDir}/scripts/pipedrive.sh activities show <id>          # Get activity details
{baseDir}/scripts/pipedrive.sh activities create --subject "Call" --type call --deal <id>
{baseDir}/scripts/pipedrive.sh activities done <id>          # Mark activity done

Pipelines & Stages

{baseDir}/scripts/pipedrive.sh pipelines list                # List all pipelines
{baseDir}/scripts/pipedrive.sh pipelines stages <pipeline_id>  # List stages in pipeline

Leads

{baseDir}/scripts/pipedrive.sh leads list                    # List all leads
{baseDir}/scripts/pipedrive.sh leads show <id>               # Get lead details
{baseDir}/scripts/pipedrive.sh leads create --title "New Lead" --person <id>
{baseDir}/scripts/pipedrive.sh leads convert <id>            # Convert lead to deal

Products

{baseDir}/scripts/pipedrive.sh products list                 # List all products
{baseDir}/scripts/pipedrive.sh products search "query"       # Search products

Notes

{baseDir}/scripts/pipedrive.sh notes list --deal <id>        # Notes for a deal
{baseDir}/scripts/pipedrive.sh notes list --person <id>      # Notes for a person
{baseDir}/scripts/pipedrive.sh notes create --content "Note text" --deal <id>

Deal Statuses

• open - Active deal in pipeline
• won - Deal closed-won
• lost - Deal closed-lost
• deleted - Deleted deal

Activity Types

Common types: call, meeting, task, deadline, email, lunch

Notes

• API Base: https://api.pipedrive.com/v1
• Auth: API token via api_token query param
• Rate limit: 10 req/second, 100,000/day per company
• Pagination: Use start (offset) and limit params
• Always confirm before creating/updating/deleting records

API Reference

For detailed endpoint documentation, see references/api.md.