Zum Inhalt springen
Sursa Developers

Ereignisse · Personen und Zugriff

user.updated

Benutzer aktualisiert

Felder des Benutzers haben sich geändert: Name, E-Mail, Login, Rolle oder Status (data.previous_attributes enthält die vorherigen Werte).

Objekttyp
user
Zugestellt an
Endpunkte mit der Rolle admin

Payload

Objekt: EventUserUpdated

  • idstringerforderlich

    Ereignis-ID (evt_…), auch als Header webhook-id gesendet. Verwenden Sie sie, um doppelte Zustellungen zu verwerfen.

  • typestringerforderlich

    Zulässige Werte: user.updated

  • created_atstring (date-time)erforderlich

    Wann die Änderung stattgefunden hat (UTC).

  • org_idintegererforderlich
  • api_versionstringerforderlich

    Vertragsversion des Schemas von data.

  • sequenceinteger

    Laufende Nummer der Zustellung innerhalb des Endpunkts (fehlt bei einem Testereignis).

  • objectWebhookEventObjecterforderlich
  • payloadstringerforderlich

    thin bedeutet kein data: Lesen Sie das Objekt über die API.

    Zulässige Werte: fullthin

  • dataobject
    Felder
    • userEventUsererforderlich
    • actor_idinteger | nullerforderlich

      Der Benutzer, der die Aktion ausgeführt hat; null bei einem API-Schlüssel der Organisation oder der Plattform selbst.

    • previous_attributesobjecterforderlich

      Vorherige Werte der geänderten Felder der obersten Ebene des Objekts.

  • testbooleanerforderlich

    Ein Testereignis, gesendet durch POST /v1/webhooks/{webhook_id}/test.

Beispielzustellung

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "user.updated",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "user",
    "id": "11"
  },
  "payload": "full",
  "data": {
    "user": {
      "id": 11,
      "username": "anna",
      "display_name": "Anna Smith",
      "email": "anna@example.com",
      "role": "editor",
      "active": true
    },
    "actor_id": 7,
    "previous_attributes": {
      "role": "viewer"
    }
  },
  "test": false
}

Ereignisse empfangen

Jede Zustellung ist eine POST-Anfrage mit diesem JSON-Body an Ihren Endpunkt. Prüfen Sie den Header webhook-signature (Standard Webhooks), bevor Sie dem Body vertrauen, antworten Sie innerhalb weniger Sekunden mit einem Status 2xx und erledigen Sie die Arbeit danach. Zustellungen an einen Endpunkt behalten die Reihenfolge der Ereignisse bei; eine fehlgeschlagene Zustellung wird mit wachsenden Pausen wiederholt.

Neue Ereignistypen und neue Felder können jederzeit hinzukommen: Überspringen Sie Typen und Felder, die Sie nicht kennen.

Dieselben Ereignisse stehen 30 Tage lang im Ereignis-Feed →