Custom webhook

corween posílá události monitorování na HTTP endpoint, který nastavíte v nastavení.

Přehled

Když jsou notifikace k odeslání, corween pošle POST požadavek na webhook URL uloženou v nastavení účtu.

POST Vaše webhook URL

HTTP požadavek

Požadavek jde na URL, kterou jste zadali. Na naší straně není pevná cesta — endpoint si volíte vy.

Metoda
POST
Content-Type
application/json

Payload

Tělo je JSON objekt s polem events. Každá položka popisuje jednu událost.

Název Typ Popis
events array Pole událostí zahrnutých v této notifikaci.
events[].subject object Sledovaný subjekt, ke kterému událost patří.
events[].subject.registrationNumber string Identifikátor firmy (IČO, KRS, …). U osob může být prázdné.
events[].subject.birthDate date Datum narození osoby v ISO formátu (YYYY-MM-DD). U firem prázdné.
events[].subject.name string Název subjektu.
events[].eventText string Lidsky čitelný popis události.
events[].eventDate date Datum události v ISO formátu (YYYY-MM-DD).
events[].eventSeverity string Závažnost události. Jedna z: INFO, MEDIUM, HIGH.

Příklad

Tělo požadavku
{
  "events": [
    {
      "subject": {
        "registrationNumber": "12345678",
        "birthDate": null,
        "name": "Example s.r.o."
      },
      "eventText": "Company entered insolvency proceedings.",
      "eventDate": "2026-08-20",
      "eventSeverity": "HIGH"
    }
  ]
}