v1Ressourcen/Clients/patchBenutzer des Kundenportals ändern
Benutzer des Kundenportals ändern
Gespeicherte Portalbenutzer lesen, ohne alte Kontaktbenutzer anzulegen. Per E-Mail hinzufügen; sendInvite ist standardmäßig true. Ein Versandfehler lässt den Benutzer bestehen. Änderungen erlauben nur Aktivieren, Deaktivieren oder Eigentumsübertragung mit makePrimary=true. Entfernen lässt offene Anmeldelinks ablaufen; ein Inhaber mit weiteren Benutzern kann nicht entfernt werden. Widerruf löscht nur eingeladene Benutzer ohne erste Anmeldung und beendet alle offenen Links.
patch
clients:write/api/v1/clients/{id}/users/{userId}Query-Parameter
idstringerforderlich
userIdstringerforderlich
Anfragetext
statusstring (active | disabled)optional
makePrimaryboolean (true)optional
Antwort
dataobjecterforderlich
userobjectoptional
idstringoptional
emailstringoptional
firstNamestringoptional
lastNamestringoptional
statusstringoptional
isPrimarybooleanoptional
rolestring (owner | member)optional
invitedAtstringoptional
lastLoginAtstringoptional
inviteSentAtstringoptional
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie eine Gutschrift mit demselben Idempotenzschlüssel.
patch/api/v1/clients/{id}/users/{userId}
Ihr API-Schlüssel
id *
userId *
Anfragetext
{}Anleitungen, die diese Ressource verwenden
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.