v1Ressourcen/Connections/postVerbindungslink erstellen
Verbindungslink erstellen
Erstellt einen einmal nutzbaren Link, der ein Konto eines Kunden auf Markenebene bei Facebook, Instagram, LinkedIn, X, Pinterest oder YouTube verbindet. Senden Sie die url an eine Person mit Zugriff auf den Kunden in Synup: Sie öffnet ihn angemeldet und bestätigt die Verbindung in ihrem eigenen Browser. Der Link funktioniert einmal und läuft nach einer Stunde ab, wenn ihn niemand öffnet. Dieser Endpunkt stellt die Verbindung nie selbst her; prüfen Sie den Status des Links, um zu sehen, wann sie abgeschlossen ist. YouTube muss für den Workspace aktiviert sein (sonst 403).
post
connections:write/api/v1/connections/connect-linksAnfragetext
clientIdstringerforderlich
Der Kunde, dessen Konto verbunden werden soll.
platformstring (facebook | instagram | linkedin | x | pinterest | youtube)erforderlich
Das zu verbindende Netzwerk: facebook, instagram, linkedin, x, pinterest oder youtube.
reconnectConnectionIdstringoptional
Eine bestehende Verbindung dieses Kunden, die neu verbunden werden soll, statt eine neue hinzuzufügen. Nur Facebook und YouTube.
Antwort
dataobjectoptional
idstringoptional
Die ID des Links. Damit prüfen Sie den Status oder stornieren den Link.
platformstringoptional
Das Netzwerk, das der Link verbindet.
clientIdstringoptional
Der Kunde, für den der Link gilt.
statusstring (pending | started | completed | abandoned | cancelled | expired)optional
Wo der Link steht: pending (noch nicht geöffnet), started (geöffnet, die Person hat noch nicht abgeschlossen), completed (das Konto ist verbunden), abandoned (geöffnet, aber nicht innerhalb einer Stunde abgeschlossen), cancelled oder expired (vor expiresAt nicht geöffnet).
expiresAtstringoptional
Wann der Link ungültig wird, wenn ihn niemand geöffnet hat.
startedAtstringoptional
Wann der Link geöffnet wurde, oder null, wenn noch nicht.
connectionIdstringoptional
Die Verbindung, die der Link erzeugt hat, sobald er abgeschlossen ist. Bis dahin null.
reconnectConnectionIdstringoptional
Die neu zu verbindende Verbindung, wenn der Link dafür erstellt wurde. Nur die Antwort beim Erstellen enthält sie; Statusabfragen liefern null.
urlstringoptional
Der zu sendende Link. Er öffnet sich im Browser, enthält keine Zugangsdaten und funktioniert einmal.
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/connections/connect-links
Ihr API-Schlüssel
Anfragetext*
{}Anleitungen, die diese Ressource verwenden
- What Is a Business Listings API?A business listings API manages a business's name, address, hours and more across many publishers at once, with sync status and duplicate detection built in.
- 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.
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- 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 Update Business Information Across Google, Apple, Bing and DirectoriesPush one business-information change to Google, Apple, Bing and the directory network through a single API call, and verify it reached each publisher.
- How to Manage Thousands of Business Locations via APIDesign a sync job for thousands of locations on the Synup API with cursor pagination, tags, rate-limit handling, an id map and rollup health checks.
- How Google Business Profile Synchronization WorksGoogle Business Profile sync rests on an owner's OAuth consent, matching a location to the right Google listing, then a write-and-verify loop.
- 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 Connect and Manage Google Business Profiles via APIConnect a Google Business Profile to a location, match the account's listings, keep the profile in sync and handle reconnects with the Synup API.
- Building Publisher Integrations Directly vs Using SynupWhat it really costs to integrate Google, Apple, Bing and directories yourself, versus one API, and how to decide between them or combine both.