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.
| Campo | Tipo | Descripción |
|---|---|---|
name | string, hasta 80 caracteres | Etiqueta en la lista de enlaces del panel. Solo la ve tu equipo |
visibility | PUBLIC o PRIVATE | PRIVATE muestra al cliente solo las cuentas que conectó con este enlace. Por defecto PUBLIC |
allowedPlatforms | array de tipos de plataforma | Plataformas que el cliente puede elegir. Omítelo o envía [] para todas |
maxAccounts | entero, 1 o más | El enlace deja de funcionar cuando se conectan tantas cuentas con él. Volver a conectar una cuenta que ya conectó no cuenta otra vez |
expiresAt | fecha y hora ISO 8601 con Z o un desfase | Cuándo deja de funcionar el enlace. Entre 1 hora y 365 días a partir de ahora. Por defecto, dentro de 7 días |
neverExpires | booleano | true mantiene el enlace activo hasta que lo revoques. No lo envíes junto con expiresAt |
Petición de ejemplo:
{
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3,
"expiresAt": "2026-11-30T18:00:00Z"
}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
}| Campo | Descripción |
|---|---|
url | La página que envías. Quien la tenga puede conectar cuentas a este espacio de trabajo mientras el enlace funcione |
token | Identifica el enlace. Guárdalo para revocarlo más tarde |
expiresAt | Cuándo deja de funcionar el enlace, o null si no caduca nunca |
name, visibility, allowedPlatforms, maxAccounts | La configuración con la que se creó el enlace. name y maxAccounts son null si no se indicaron |
Un expiresAt fuera del rango, o expiresAt junto con neverExpires, devuelve 400 con un mensaje que indica el motivo.
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.
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.