REST APIPOST

Enlaces de conexión

Crea un enlace para que un cliente conecte sus cuentas sociales a tu espacio de trabajo sin iniciar sesión en AdaptlyPost, y revócalo cuando termines.

Permiso: accounts.manage. Consulta Roles y permisos.

Solo una clave de Administrador tiene accounts.manage, así que solo las claves de Administrador pueden crear o revocar enlaces de conexión.

Un enlace de conexión abre una página donde alguien sin cuenta de AdaptlyPost conecta sus cuentas sociales a tu espacio de trabajo. Envía la url a un cliente, este aprueba cada plataforma y las cuentas aparecen en Social Accounts como cualquier otra.

POST /api/v1/connect-links

Todos los campos son opcionales. Sin cuerpo obtienes un enlace rápido: ofrece todas las plataformas, muestra al cliente todas las cuentas del espacio de trabajo, conecta cualquier número de cuentas y deja de funcionar a los 7 días.

CampoTipoDescripción
namestring, hasta 80 caracteresEtiqueta en la lista de enlaces del panel. Solo la ve tu equipo
visibilityPUBLIC o PRIVATEPRIVATE muestra al cliente solo las cuentas que conectó con este enlace. Por defecto PUBLIC
allowedPlatformsarray de tipos de plataformaPlataformas que el cliente puede elegir. Omítelo o envía [] para todas
maxAccountsentero, 1 o másEl enlace deja de funcionar cuando se conectan tantas cuentas con él. Volver a conectar una cuenta que ya conectó no cuenta otra vez
expiresAtfecha y hora ISO 8601 con Z o un desfaseCuándo deja de funcionar el enlace. Entre 1 hora y 365 días a partir de ahora. Por defecto, dentro de 7 días
neverExpiresbooleanotrue mantiene el enlace activo hasta que lo revoques. No lo envíes junto con expiresAt
returnUrlURL https, hasta 2048 caracteresAdónde va el cliente después de conectar, elegir páginas o canales o recibir un rechazo, para que vuelva a tu app. Debe ser https (http solo para localhost) y no llevar usuario ni contraseña. Tus propios parámetros de consulta se conservan

Petición de ejemplo:

{
  "name": "Acme onboarding",
  "visibility": "PRIVATE",
  "allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
  "maxAccounts": 3,
  "expiresAt": "2026-11-30T18:00:00Z",
  "returnUrl": "https://app.example.com/social/connected?client=42"
}

Devuelve 201:

{
  "url": "https://adaptlypost.com/connect/9f2c4e71b0d8...",
  "token": "9f2c4e71b0d8...",
  "expiresAt": "2026-11-30T18:00:00.000Z",
  "name": "Acme onboarding",
  "visibility": "PRIVATE",
  "allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
  "maxAccounts": 3,
  "returnUrl": "https://app.example.com/social/connected?client=42",
  "startUrls": [
    { "platform": "INSTAGRAM", "url": "https://auth.adaptlypost.com/auth/connect/9f2c4e71b0d8.../INSTAGRAM/start" },
    { "platform": "TIKTOK", "url": "https://auth.adaptlypost.com/auth/connect/9f2c4e71b0d8.../TIKTOK/start" }
  ]
}
CampoDescripción
urlLa página que envías. Quien la tenga puede conectar cuentas a este espacio de trabajo mientras el enlace funcione
tokenIdentifica el enlace. Guárdalo para revocarlo más tarde
expiresAtCuándo deja de funcionar el enlace, o null si no caduca nunca
name, visibility, allowedPlatforms, maxAccountsLa configuración con la que se creó el enlace. name y maxAccounts son null si no se indicaron
returnUrlLa returnUrl con la que se creó el enlace, o null
startUrlsUn { platform, url } por cada plataforma ofrecida que conecta a través de la pantalla de consentimiento de la propia red. Bluesky y Telegram no aparecen porque se conectan en la página del enlace. Añade server a la URL de Mastodon, site a la de WordPress y via=facebook a la de Instagram para conectar Instagram a través de su página de Facebook

Un expiresAt fuera del rango, o expiresAt junto con neverExpires, devuelve 400 con un mensaje que indica el motivo. Una returnUrl que no es https, o que lleva usuario o contraseña, también devuelve 400.

Un enlace también deja de funcionar en cuanto se revoca, cuando ya conectó maxAccounts cuentas, o cuando el miembro que lo creó ya no puede gestionar cuentas en el espacio de trabajo.

Tus propios botones de conexión

Envía returnUrl y pon cada entrada de startUrls detrás de un botón en tu app. El botón lleva al cliente directamente a la pantalla de consentimiento de la red, sin pasar por la página del enlace. Después de conectar, elegir páginas o canales o recibir un rechazo, el cliente llega a returnUrl con estos parámetros de consulta añadidos:

ParámetroDescripción
statusconnected o error
platformEl tipo de plataforma, cuando se conoce
accountIdUno por cada cuenta que añadió la conexión, el mismo id que lista Social Accounts. Elegir páginas o canales puede añadir varios
errorSi hay un error, un código, por ejemplo cancelled cuando el cliente cerró el selector
messageSi hay un error, un texto que puedes mostrar al cliente, cuando lo hay

Una contraseña de Bluesky o WordPress incorrecta deja al cliente en la página del enlace para que lo intente de nuevo.

DELETE /api/v1/connect-links/:token

Revoca el enlace al instante. Las cuentas ya conectadas con él siguen conectadas. Devuelve { "success": true }, o 404 si ningún enlace de este espacio de trabajo tiene ese token.