Manage Pipedrive CRM from Your AI Agent with the Pipedrive Skill

Sales teams live and die by their CRM. If you're using Pipedrive to track deals, contacts, and your sales pipeline, the Pipedrive skill lets your AI agent query, create, and update CRM data without ever opening a browser tab.

This guide shows you how to set up and use the Pipedrive skill to automate your sales workflows directly from Clawdbot.

Who Needs This?

Sales reps who want to log activities or check deal status through chat
Sales managers who need quick pipeline reports without digging through dashboards
RevOps teams automating CRM data hygiene and updates
Anyone who's tired of context-switching between their AI assistant and Pipedrive

Installation

Install the skill with a single command:

npx clawhub@latest install pipedrive-api

Setup: Getting Your Maton API Key

The Pipedrive skill uses the Maton gateway for secure OAuth management. You'll need a Maton API key:

Sign up or log in at maton.ai
Navigate to maton.ai/settings
Copy your API key
Set the environment variable:

export MATON_API_KEY="your-api-key-here"

Pro tip: Add this to your shell profile (.zshrc or .bashrc) so it's always available.

Connecting to Pipedrive

Before making API calls, you need to link your Pipedrive account via OAuth:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({"app": "pipedrive"}).encode()
req = urllib.request.Request("https://ctrl.maton.ai/connections", data=data, method="POST")
req.add_header("Authorization", f"Bearer {os.environ[MATON_API_KEY]}")
req.add_header("Content-Type", "application/json")
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

This returns a URL—open it in your browser to complete the OAuth flow. Once done, you're ready to start querying.

Usage Examples

1. List Your Open Deals

Quickly see what's in your pipeline:

import os, requests

headers = {"Authorization": f"Bearer {os.environ[MATON_API_KEY]}"}
deals = requests.get(
    "https://gateway.maton.ai/pipedrive/api/v1/deals",
    headers=headers,
    params={"status": "open", "limit": 10}
).json()

for deal in deals.get("data", []):
    print(f"{deal[title]} - ${deal.get(value, 0)} ({deal.get(stage_id)})")

2. Create a New Deal from a Conversation

Turn a meeting into a tracked opportunity:

response = requests.post(
    "https://gateway.maton.ai/pipedrive/api/v1/deals",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "title": "Enterprise License - Acme Corp",
        "value": 50000,
        "currency": "USD",
        "person_id": 123,
        "expected_close_date": "2025-06-30"
    }
)

3. Log a Follow-up Activity

Schedule your next touchpoint without leaving the chat:

requests.post(
    "https://gateway.maton.ai/pipedrive/api/v1/activities",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "subject": "Contract review call",
        "type": "call",
        "due_date": "2025-03-20",
        "due_time": "14:00",
        "deal_id": 789,
        "note": "Discuss pricing terms"
    }
)

Key Endpoints

The skill provides access to all major Pipedrive resources:

Deals: /pipedrive/api/v1/deals — create, list, update, search deals
Persons: /pipedrive/api/v1/persons — manage contacts
Organizations: /pipedrive/api/v1/organizations — company records
Activities: /pipedrive/api/v1/activities — calls, meetings, tasks
Pipelines & Stages: /pipedrive/api/v1/pipelines, /pipedrive/api/v1/stages
Notes: /pipedrive/api/v1/notes — attach notes to deals/contacts

Tips & Best Practices

Multiple connections? If you have several Pipedrive accounts linked, specify which one to use with the Maton-Connection header
Pagination: Use start and limit parameters for large result sets (default limit is 100)
Custom fields: Access custom fields using their API key (e.g., abc123_custom_field)
Rate limits: The gateway enforces 10 requests/second per account

Common Use Cases

Morning standup prep: "Show me deals closing this week"
Post-call logging: "Create a follow-up task for my call with Sarah"
Pipeline review: "What's our total pipeline value for Q2?"
Contact lookup: "Find John from Acme Corp's contact info"

Conclusion

The Pipedrive skill turns your AI agent into a CRM assistant that never forgets to log activities or loses track of deals. Combined with Clawdbot's natural language interface, you can manage your sales pipeline as easily as sending a message.

Links: