Webhook Integration

The generic Webhook integration allows you to connect Uptimeify with any system (e.g., Zapier, Microsoft Teams, Custom Scripts).

Setup

  1. Target URL: Enter the URL of your endpoint.
  2. Method: Select the HTTP method (usually POST).
  3. Header (Optional): Add authentication headers (e.g., Authorization: Bearer ...).

Payload Format

We send a JSON payload with the following structure:

{
  "event": "incident.created",
  "incident": {
    "id": 123,
    "type": "down",
    "status": "open",
    "started_at": "2025-12-03T18:50:03.000Z",
    "error_message": "503 Service Unavailable"
  },
  "website": {
    "id": 45,
    "name": "Wiki",
    "url": "https://wiki.haupt.design",
    "custom_fields": {
      "datacenter": "fra1",
      "service": "wiki"
    }
  },
  "customer": {
    "id": 10,
    "name": "Zaskoku & Haupt GbR"
  }
}

Website Custom Fields

If you configured website custom fields, they are included as website.custom_fields. If you did not configure any custom fields, the field may be missing or empty (depending on the event).

Security

You can configure a Secret. We will then sign the payload with HMAC-SHA256 in the X-Webhook-Signature header so you can verify the authenticity of the request.