Wie können bestehende Gruppen über die API befüllt (geupdated) werden?

Es kann vorkommen, dass Gruppen manuell über die Mitarbeiter App oder den Excel-Import erstellt wurden und im Nachhinein durch die API mit Nutzer:innen befüllt werden sollen. Dies lässt sich in drei einfachen Schritten umsetzen. Wenn die Gruppen über die API erstellt wurden ist Schritt 3 ausreichend.

1. Gruppen abfragen
   In diesem Fall ist es notwendig zunächst die “group_id” über den "Get all existing groups" Request abzufragen. Alle Gruppen, welche in der Antwort keine ”external_id” haben wurden entweder per Excel-Import oder über das Admin Dashboard händisch in der App erstellt.
   
   
2. external_id vergeben
   Anschließend muss diesen Gruppen über den "Create or update multiple groups at once" Request eine “external_id” vergeben werden. Hierzu muss für das Feld “group_id” der Wert aus dem vorherigen Request und der Gruppenname “name” angegeben werden.
   
   
3. User zu Gruppen hinzufügen
   Um die Nutzer:innen nun zu dieser Gruppe hinzuzufügen, sollte für die dafür vorgesehenen Nutzer:innen im Feld “group_membership” die “group_external_id” dieser Gruppe und die entsprechende “group_role”, also der Rolle der Nutzer:innen in der Gruppe, mitgegeben werden.