Custom webhook

corween wysyła zdarzenia monitorowania na endpoint HTTP skonfigurowany w ustawieniach.

Przegląd

Gdy powiadomienia są do wysłania, corween wysyła żądanie POST na URL webhooka zapisany w ustawieniach konta.

POST Twój URL webhooka

Żądanie HTTP

Żądanie idzie na URL, który podałeś. Po naszej stronie nie ma stałej ścieżki — endpoint wybierasz Ty.

Metoda
POST
Content-Type
application/json

Payload

Treść to obiekt JSON z tablicą events. Każdy element opisuje jedno zdarzenie.

Nazwa Typ Opis
events array Tablica zdarzeń zawartych w tym powiadomieniu.
events[].subject object Monitorowany podmiot, do którego należy zdarzenie.
events[].subject.registrationNumber string Identyfikator firmy (IČO, KRS, …). Dla osób może być puste.
events[].subject.birthDate date Data urodzenia osoby w formacie ISO (YYYY-MM-DD). Dla firm puste.
events[].subject.name string Nazwa podmiotu.
events[].eventText string Czytelny opis zdarzenia.
events[].eventDate date Data zdarzenia w formacie ISO (YYYY-MM-DD).
events[].eventSeverity string Ważność zdarzenia. Jedna z: INFO, MEDIUM, HIGH.

Przykład

Treść żądania
{
  "events": [
    {
      "subject": {
        "registrationNumber": "12345678",
        "birthDate": null,
        "name": "Example s.r.o."
      },
      "eventText": "Company entered insolvency proceedings.",
      "eventDate": "2026-08-20",
      "eventSeverity": "HIGH"
    }
  ]
}