v1Recursos/Connections/postCrear un enlace de conexión
Crear un enlace de conexión
Crea un enlace de un solo uso que conecta una cuenta de marca de un cliente en Facebook, Instagram, LinkedIn, X, Pinterest o YouTube. Envía la url a alguien con acceso al cliente en Synup: la abre con su sesión iniciada y aprueba la conexión en su propio navegador. El enlace funciona una vez y caduca al cabo de una hora si nadie lo abre. Este endpoint nunca completa la conexión por sí mismo; consulta el estado del enlace para saber cuándo termina. YouTube debe estar habilitado para el espacio de trabajo (403 en caso contrario).
post
connections:write/api/v1/connections/connect-linksCuerpo de la solicitud
clientIdstringobligatorio
El cliente cuya cuenta se va a conectar.
platformstring (facebook | instagram | linkedin | x | pinterest | youtube)obligatorio
La red que se va a conectar: facebook, instagram, linkedin, x, pinterest o youtube.
reconnectConnectionIdstringopcional
Una conexión existente de este cliente que se reconecta en lugar de añadir una nueva. Solo Facebook y YouTube.
Respuesta
dataobjectopcional
idstringopcional
El id del enlace. Úsalo para consultar el estado o cancelar el enlace.
platformstringopcional
La red que conecta el enlace.
clientIdstringopcional
El cliente para el que es el enlace.
statusstring (pending | started | completed | abandoned | cancelled | expired)opcional
En qué punto está el enlace: pending (aún no abierto), started (abierto, a la espera de que la persona termine), completed (la cuenta está conectada), abandoned (abierto pero no terminado en una hora), cancelled o expired (no abierto antes de expiresAt).
expiresAtstringopcional
Cuándo deja de funcionar el enlace si nadie lo ha abierto.
startedAtstringopcional
Cuándo se abrió el enlace, o null si aún no se ha abierto.
connectionIdstringopcional
La conexión que produjo el enlace, una vez completado. Null hasta entonces.
reconnectConnectionIdstringopcional
La conexión que se reconecta, cuando el enlace se creó para reconectar una. Solo la devuelve la respuesta de creación; las consultas de estado devuelven null.
urlstringopcional
El enlace que hay que enviar. Se abre en un navegador, no lleva credenciales y funciona una vez.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/connections/connect-links
Su clave de API
Cuerpo de la solicitud*
{}Guías que usan este recurso
- 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.