Pipedrive

Pipedrive API — это интеграция с Pipedrive через управляемую OAuth-аутентификацию. Позволяет работать со сделками, контактами, организациями, активностями и воронками продаж, упрощая автоматизацию CRM-процессов. :

Быстрый старт

# Получить список сделок
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/pipedrive/api/v1/deals')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/pipedrive/{native-api-path}

Замените {native-api-path} на нужный endpoint Pipedrive API. Gateway автоматически проксирует запросы к api.pipedrive.com и подставляет OAuth-токен. :

Аутентификация

Все запросы требуют API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Задайте ключ как переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Зарегистрируйтесь или войдите на maton.ai
• Перейдите в настройки
• Скопируйте API-ключ

Управление подключениями

OAuth-подключения к Pipedrive управляются через:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=pipedrive&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

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

Получение подключения

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Пример ответа:

{
 "connection": {
 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
 "status": "ACTIVE",
 "creation_time": "2025-12-08T07:20:53.488460Z",
 "last_updated_time": "2026-01-31T20:03:32.593153Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "pipedrive",
 "metadata": {}
 }
}

Откройте поле url в браузере, чтобы завершить OAuth-авторизацию. :

Работа со сделками

Список сделок

GET /pipedrive/api/v1/deals

• status — фильтр по статусу (open, won, lost)
• limit — количество элементов
• start — смещение

Создание сделки

POST /pipedrive/api/v1/deals

{
 "title": "Новая сделка",
 "value": 50000,
 "currency": "USD"
}

Обновление сделки

PUT /pipedrive/api/v1/deals/{id}

Удаление сделки

DELETE /pipedrive/api/v1/deals/{id}

Контакты (Persons)

GET /pipedrive/api/v1/persons
POST /pipedrive/api/v1/persons
PUT /pipedrive/api/v1/persons/{id}
DELETE /pipedrive/api/v1/persons/{id}

Организации

GET /pipedrive/api/v1/organizations
POST /pipedrive/api/v1/organizations
PUT /pipedrive/api/v1/organizations/{id}
DELETE /pipedrive/api/v1/organizations/{id}

Активности

GET /pipedrive/api/v1/activities
POST /pipedrive/api/v1/activities
PUT /pipedrive/api/v1/activities/{id}
DELETE /pipedrive/api/v1/activities/{id}

Воронки и стадии

GET /pipedrive/api/v1/pipelines
GET /pipedrive/api/v1/stages

Примечания и пользователи

GET /pipedrive/api/v1/notes
POST /pipedrive/api/v1/notes

GET /pipedrive/api/v1/users
GET /pipedrive/api/v1/users/me

Пример на JavaScript

const headers = {
 'Authorization': `Bearer ${process.env.MATON_API_KEY}`
};

// Получить открытые сделки
const deals = await fetch(
 'https://gateway.maton.ai/pipedrive/api/v1/deals?status=open',
 { headers }
).then(r => r.json());