Webhook-Integration - absentify®

Bei einem abonnierten Ereignis sendet absentify einen HTTP-POST an deine URL.

Netzwerkanforderungen

Wenn dein Endpunkt hinter einer Firewall liegt, erlaube die ausgehende IP-Adresse 4.231.227.89.

Webhooks konfigurieren

Öffne als Administrator Einstellungen > Integrationen.
Wähle URL konfigurieren und gib den Zielendpunkt ein.
Wähle einen Ereignistyp: Alle Anfragen, Anfrage erstellt, Anfragestatus geändert, Benutzer erstellt, Benutzer aktualisiert oder Alle Benutzer.
Wähle Hinzufügen.

Payload-Versionen

Webhooks aus der Oberfläche verwenden aktuell das v1-Format. Ein Versionswähler ist noch nicht verfügbar.

Version	Beschreibung	Status
v1	Aktuelles Format aller konfigurierten Webhooks	Aktiv
v2	Public-API-v1-Antwort in `{ event_type, body }`	Geplant

Ereignistypen

Wert	Bedeutung
`request_created`	Abwesenheitsanfrage erstellt
`request_status_changed`	Status einer Anfrage geändert
`user_created`	Benutzer erstellt
`user_updated`	Benutzer aktualisiert

v1-Payloads

Anfrageereignisse senden ein flaches Objekt. event_type steht neben den Anfragedaten; es gibt keinen body-Wrapper.

{
  "event_type": "request_created",
  "id": "string",
  "request_creator_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
  "createdAt": "2026-01-15T10:00:00.000Z",
  "updatedAt": "2026-01-15T10:00:00.000Z",
  "start": "2026-01-20T00:00:00.000Z",
  "end": "2026-01-22T00:00:00.000Z",
  "start_at": "morning | afternoon",
  "end_at": "lunchtime | end_of_day",
  "leave_unit": "days | half_days | hours | minutes_30 | minutes_15 | minutes_10 | minutes_5 | minutes_1",
  "year": 2026,
  "duration": 3,
  "details": {
    "status": "PENDING | APPROVED | DECLINED | CANCELED",
    "deducted": 3,
    "allowance_delta": 3,
    "reason": "string | null",
    "approval_process": "string",
    "cancel_reason": "string | null",
    "canceld_date": "2026-01-15T10:00:00.000Z | null",
    "canceld_by_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
    "approver_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
    "approved_date": "2026-01-15T10:00:00.000Z | null",
    "decline_reason": "string | null",
    "declined_by_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
    "declined_date": "2026-01-15T10:00:00.000Z | null",
    "request_approvers": [
      {
        "id": "string",
        "status": "PENDING | APPROVED | DECLINED",
        "approver_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
        "reason": "string | null",
        "status_change_date": "2026-01-15T10:00:00.000Z | null",
        "predecessor_request_approver_id": "string | null"
      }
    ],
    "request_representative_approvers": [
      {
        "id": "string",
        "status": "PENDING | APPROVED | DECLINED | CANCELED | REPLACED",
        "approver_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
        "replaced_to_member": { "id": "string", "name": "string", "email": "string", "custom_id": "string | null" },
        "reason": "string | null",
        "status_change_date": "2026-01-15T10:00:00.000Z | null",
        "predecessor_request_approver_id": "string | null"
      }
    ],
    "requester_member": {
      "id": "string",
      "name": "string",
      "email": "string",
      "custom_id": "string | null",
      "allowances": [
        {
          "allowance_type_id": "string",
          "allowance": 25,
          "brought_forward": 5,
          "compensatory_time_off": 0,
          "remaining": 18,
          "taken": 7,
          "year": 2026
        }
      ]
    },
    "leave_type": {
      "id": "string",
      "name": "string",
      "take_from_allowance": true,
      "leave_unit": "days | half_days | hours | minutes_30 | minutes_15 | minutes_10 | minutes_5 | minutes_1",
      "allowance_type": { "id": "string", "name": "string", "ignore_allowance_limit": false, "allowance_unit": "days | hours" }
    }
  }
}

Feld	Bedeutung
`event_type`	Unterscheidet Erstellung und Statusänderung.
`leave_unit`	Auf der Anfrage gespeicherte Einheit; bestimmt `duration` und `details.deducted`.
`details.leave_type.leave_unit`	Aktuelle Einheit der Abwesenheitsart für neue Anfragen; kann bei historischen Anfragen abweichen.
`details.status`	Aktueller Status der Anfrage.
`canceld_date`, `cancel_reason`, `canceld_by_member`	Werte einer stornierten Anfrage. Die Schreibweise `canceld_*` entspricht der Payload.
`details.allowance_delta`	Positiv, solange die Anfrage Kontingent verbraucht; nach Stornierung oder Ablehnung negativ.
`details.requester_member.allowances[]`	Wirksamer Jahreswert, Verbrauch und verbleibendes Kontingent je Kontingentart.
`details.request_representative_approvers`	Vertreter im Genehmigungsablauf.

Benutzerereignisse verwenden einen Wrapper:

{
  "event_type": "user_updated",
  "body": {
    "id": "string",
    "email": "string | null",
    "name": "string | null",
    "custom_id": "string | null",
    "created_at": "2026-01-15T10:00:00.000Z",
    "updated_at": "2026-01-15T10:00:00.000Z",
    "status": "ACTIVE | INACTIVE",
    "is_admin": false,
    "has_billing_access": false,
    "employment_start_date": "2026-01-01T00:00:00.000Z | null",
    "employment_end_date": "2026-12-31T00:00:00.000Z | null",
    "birthday": "1990-05-15T00:00:00.000Z | null",
    "public_holiday": { "id": "string", "name": "string" },
    "departments": [{ "id": "string", "name": "string" }]
  }
}

Kontingentwerte in Webhooks sind wirksame Werte aus Regel plus manuellen Anpassungen und stimmen mit der REST API überein. Namen sind gespeicherte Namen; Webhooks akzeptieren kein locale.

Geplantes v2-Format

v2 soll Anfrage- und Benutzerereignisse einheitlich verpacken:

{
  "event_type": "request_created | request_status_changed | user_created | user_updated",
  "body": {}
}

Bei Anfrageereignissen entspricht body dann GET /api/v1/requests/{id}, bei Benutzerereignissen GET /api/v1/members/{id}. v2 ist noch nicht in der Oberfläche verfügbar. Verwende bis zur Veröffentlichung das oben dokumentierte v1-Format.

Zustellungsverlauf

Das Benachrichtigungsprotokoll in den Einstellungen zeigt Ereignistyp und Ergebnis jeder Zustellung. Mit Erneut versuchen sendest du eine fehlgeschlagene Zustellung erneut.

​Netzwerkanforderungen

​Webhooks konfigurieren

​Payload-Versionen

​Ereignistypen

​v1-Payloads

​Geplantes v2-Format

​Zustellungsverlauf