Integrations

Custom webhook

corween sends monitoring events to the HTTP endpoint you configure in settings.

Overview

When notifications are due, corween sends a POST request to the webhook URL saved in your account settings.

POST Your webhook URL

HTTP request

The request is sent to the URL you entered. There is no fixed path on our side — you choose the endpoint.

Method
POST
Content-Type
application/json

Payload

The body is a JSON object with an events array. Each item describes one event.

Name Type Description
events array Array of events included in this notification.
events[].subject object Monitored subject the event belongs to.
events[].subject.registrationNumber string Company registration number (IČO, KRS, …). Empty for persons when not applicable.
events[].subject.birthDate date Date of birth for a person, in ISO format (YYYY-MM-DD). Empty for companies.
events[].subject.name string Subject name.
events[].eventText string Human-readable event description.
events[].eventDate date Date of the event, in ISO format (YYYY-MM-DD).
events[].eventSeverity string Severity of the event. One of: INFO, MEDIUM, HIGH.

Example

Request body
{
  "events": [
    {
      "subject": {
        "registrationNumber": "12345678",
        "birthDate": null,
        "name": "Example s.r.o."
      },
      "eventText": "Company entered insolvency proceedings.",
      "eventDate": "2026-08-20",
      "eventSeverity": "HIGH"
    }
  ]
}