Zum Inhalt springen
Sursa Developers

Ereignisse · Personen und Zugriff

group.member_added

Gruppenmitglied hinzugefügt

Ein Benutzer wurde zu einer Gruppe hinzugefügt.

Objekttyp
group
Zugestellt an
Endpunkte mit der Rolle admin

Payload

Objekt: EventGroupMemberAdded

  • idstringerforderlich

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

  • typestringerforderlich

    Zulässige Werte: group.member_added

  • 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
    • groupEventGrouperforderlich
    • user_idintegererforderlich
    • actor_idinteger | nullerforderlich

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

  • testbooleanerforderlich

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

Beispielzustellung

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "group.member_added",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "group",
    "id": "6"
  },
  "payload": "full",
  "data": {
    "group": {
      "id": 6,
      "key": "support-team",
      "title": "Support team",
      "kind": "regular",
      "managed_by": "manual"
    },
    "user_id": 11,
    "actor_id": 7
  },
  "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 →