Для розробників

Pipevale API та інтеграції

Автентифікація за Bearer-ключем, RESTful ендпоінти, підписки на вебхуки — і рідні підключення до Zapier, Make та ApiX-Drive.

Автентифікація

Усі запити до API потребують API-ключа. Створіть ключ у Налаштування → API-ключі і передавайте його у заголовку:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

REST API — ендпоінти

Базовий URL: https://<ваш-домен>/api/v1

Метод	Шлях	Опис	Параметри
GET	/api/v1/records	Список записів папки	folderId, search, page, pageSize
GET	/api/v1/records/:id	Один запис за ID	—
POST	/api/v1/records	Створити запис	folderId, title, email, phone, data{}
GET	/api/v1/pipelines	Список воронок (з етапами)	—
GET	/api/v1/pipelines/:id	Одна воронка за ID	—
GET	/api/v1/deals	Угоди воронки	pipelineId (обов'язковий)
POST	/api/v1/deals	Створити угоду	pipelineId, stageId?, title?, amount?, closeDate?, data{}
PATCH	/api/v1/deals/:id	Оновити угоду	stageId?, title?, amount?, closeDate?, data{}
DELETE	/api/v1/deals/:id	Видалити угоду	—
GET	/api/v1/tasks	Список задач	recordId?, status? (OPEN\|DONE)
POST	/api/v1/tasks	Створити задачу	title, dueAt?, assigneeId?, recordId?, priority?, type?, recurrence?
PATCH	/api/v1/tasks/:id	Оновити задачу	title?, dueAt?, assigneeId?, status?, priority?, type?
DELETE	/api/v1/tasks/:id	Видалити задачу	—

Приклад — список записів:

curl -H "Authorization: Bearer sk_live_xxx" \
  "https://pipevale.com/api/v1/records?folderId=<ID>&page=1&pageSize=25"

Приклад — створити запис:

curl -X POST \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"folderId":"<ID>","title":"Нова компанія","email":"ceo@example.com"}' \
  "https://pipevale.com/api/v1/records"

Вихідні вебхуки

Підпишіться на події в Налаштування → Вебхуки. Pipevale надсилатиме POST-запит на ваш URL при кожній події.

record.createdrecord.updatedrecord.deleteddeal.stage_changed

Формат payload:

{
  "event": "record.created",
  "workspaceId": "ws_xxx",
  "timestamp": "2026-06-18T10:00:00Z",
  "data": {
    "id": "rec_xxx",
    "folderId": "fld_xxx",
    "title": "Нова компанія",
    "email": "ceo@example.com",
    "data": { ... }
  }
}

Підпис у заголовку X-Pipevale-Signature: sha256=… — HMAC тіла секретом вебхука. Перевіряйте його на своєму боці.

⚡

Підключення через Zapier

Використовуйте «Webhooks by Zapier» (тригер) та «HTTP by Zapier» (дія) — без нативного конектора, просто через наш API.

1У Налаштування → API-ключі створіть ключ для Zapier. Скопіюйте значення — воно показується лише один раз.
2Тригер (нова подія з Pipevale): у Zapier оберіть «Webhooks by Zapier → Catch Hook». Скопіюйте URL. Потім у Налаштування → Вебхуки додайте новий вебхук, вставте URL і оберіть події, що цікавлять.
3Дія (записати в Pipevale): оберіть «HTTP by Zapier → POST». URL: https://<ваш-домен>/api/v1/records. Заголовок Authorization: Bearer sk_live_…. Тіло — JSON із потрібними полями.
4Протестуйте Zap і вмикайте — готово!

🔮

Підключення через Make (Integromat)

Make має гнучкий HTTP-модуль і вбудовану підтримку вебхуків — ідеально для багатокрокових сценаріїв.

1Отримайте API-ключ у Налаштування → API-ключі.
2Тригер (з Pipevale): додайте модуль «Webhooks → Custom webhook». Make згенерує URL — вставте його у Налаштування → Вебхуки і підпишіться на потрібні події.
3
Дія (в Pipevale): модуль «HTTP → Make a request».
- URL: https://<ваш-домен>/api/v1/records
- Метод: POST
- Заголовки: Authorization: Bearer sk_live_…
- Body type: Raw, Content-Type: application/json
4Запустіть сценарій і перевірте дані в Pipevale.

🔗

ApiX-Drive

ApiX-Drive — українська iPaaS-платформа із підтримкою HTTP-з'єднань. Підключіть Pipevale так само, як Zapier/Make: використовуйте модуль «HTTP Request» із Bearer-токеном і URL наших ендпоінтів.

Нативний конектор Pipevale для ApiX-Drive — у розробці. Якщо хочете отримати доступ першими — напишіть нам.

Потрібна допомога?

Наша команда допоможе з налаштуванням інтеграцій і автоматизацій.

Написати у підтримку