v1Ressources/Clients/patchModifier les notifications du client
Modifier les notifications du client
Consulter les réglages effectifs et les droits de modification. Les propriétaires et administrateurs peuvent changer les options prises en charge en conservant les valeurs omises. config=null restaure les valeurs de l’agence. Les processus d’envoi et réglages internes ne sont pas exposés.
patch
clients:write/api/v1/clients/{id}/notificationsParamètres de requête
idstringobligatoire
Corps de la requête
patchobjectfacultatif
Modifie uniquement les champs indiqués, pour ce client ou, avec clientUserId, pour l'un de ses utilisateurs du portail. null efface un champ pour que le niveau supérieur s'applique : les paramètres par défaut de l'agence pour un client, les réglages du client pour un utilisateur du portail. Les champs omis restent inchangés.
configobjectfacultatif
Enregistre toute la liste du client en une fois. null supprime les réglages propres au client, qui suit de nouveau les paramètres par défaut de l'agence. Incompatible avec clientUserId.
resetboolean (true)facultatif
true supprime les réglages enregistrés : le client suit de nouveau les paramètres par défaut de l'agence, ou l'utilisateur du portail indiqué dans clientUserId suit de nouveau les réglages du client.
clientUserIdstringfacultatif
Applique patch ou reset à un utilisateur actif du portail de ce client plutôt qu'au client dans son ensemble.
Réponse
dataobjectobligatoire
configobjectfacultatif
showToClientsbooleanfacultatif
lockedbooleanfacultatif
rowsobjectfacultatif
customizedbooleanfacultatif
canManagebooleanfacultatif
emailReadybooleanfacultatif
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le service est temporairement indisponible. Réessayez l’ajout de crédits avec la même clé d’idempotence.
patch/api/v1/clients/{id}/notifications
Votre clé API
id *
Corps de la requête
{}Guides qui utilisent cette ressource
- 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.