---
title: "Dodaj webhook"
method: POST
path: "/webhooks"
tags: ["Webhooki"]
---

# Dodaj webhook

`POST /webhooks`

## Request

- Base URL: `https://outreachpilot.pl/api/v1`
- URL: `https://outreachpilot.pl/api/v1/webhooks`
- Auth: HTTP bearer

Rejestruje publiczny adres HTTPS, na który wysyłamy podpisane (HMAC-SHA256) zdarzenia. Sekret podpisu jest zwracany TYLKO w tej odpowiedzi. Limit: 10 webhooków na konto. Zdarzenia `lead.*` i `email.*` zawierają adresy e-mail i nazwy firm, więc ich subskrypcja wymaga też zakresu `leads:read` (403 `insufficient_scope`).

**Wymagany zakres klucza:** `webhooks:write`.

## Request body

- object
  - `url` string, uri, required: Publiczny adres HTTPS (Make, Zapier, n8n, własny serwer).
  - `events` string[], required: Zdarzenia do wysyłania.

## Response `201`

Utworzono.

- object
  - `data` WebhookCreated, required
    - `id` string, required
    - `url` string, required
    - `events` string[], required
    - `is_active` boolean, required
    - `created_at` string, required: Data i czas ISO 8601 (UTC).
    - `last_triggered_at` string, nullable, required: Data i czas ISO 8601 (UTC).
    - `fail_count` integer, required: Kolejne nieudane dostawy. Po 10 dostawy są wstrzymane.
    - `secret` string, required: Sekret do weryfikacji podpisu HMAC-SHA256. Pokazywany TYLKO RAZ.

## Other responses

- `400`: Nieprawidłowe żądanie. Kody: `invalid_request`.
- `401`: Brak, zły, odwołany lub wygasły klucz (`missing_api_key`, `invalid_api_key`, `api_key_revoked`, `api_key_expired`, `account_inactive`).
- `403`: Błąd. Kody: `insufficient_scope`.
- `409`: Konflikt. Kody: `conflict`.
- `422`: Błąd walidacji. Kody: `validation_error`.
- `429`: Przekroczono limit żądań (`rate_limit_exceeded`). Zobacz nagłówek `Retry-After`.

---

[API](https://skmtc.dev/outreachpilot/apis/outreachpilot-api.md) · [All operations](https://skmtc.dev/outreachpilot/apis/outreachpilot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreachpilot/apis/outreachpilot-api/revisions/2262dabfb07c?raw)