Liens de connexion
Créez un lien qui permet à un client de connecter ses comptes sociaux à votre espace de travail sans se connecter à AdaptlyPost, puis révoquez-le quand vous avez terminé.
Permission: accounts.manage. Voir Rôles et permissions.
Seule une clé Administrateur possède accounts.manage, donc seules les clés Administrateur peuvent créer ou révoquer des liens de connexion.
Un lien de connexion ouvre une page où une personne sans compte AdaptlyPost connecte ses comptes sociaux à votre espace de travail. Envoyez l'url à un client, il approuve chaque plateforme, et les comptes apparaissent dans Social Accounts comme les autres.
POST /api/v1/connect-links
Tous les champs sont facultatifs. Sans corps, vous obtenez un lien rapide : il propose toutes les plateformes, montre au client tous les comptes de l'espace de travail, connecte un nombre illimité de comptes et cesse de fonctionner au bout de 7 jours.
| Champ | Type | Description |
|---|---|---|
name | chaîne, 80 caractères maximum | Libellé dans la liste des liens du tableau de bord. Seule votre équipe le voit |
visibility | PUBLIC ou PRIVATE | PRIVATE ne montre au client que les comptes qu'il a connectés avec ce lien. PUBLIC par défaut |
allowedPlatforms | tableau de types de plateforme | Plateformes que le client peut choisir. Omettez-le ou envoyez [] pour toutes |
maxAccounts | entier, 1 ou plus | Le lien cesse de fonctionner dès que ce nombre de comptes est connecté avec lui. Reconnecter un compte qu'il a déjà connecté ne compte pas une seconde fois |
expiresAt | date et heure ISO 8601 avec Z ou un décalage | Quand le lien cesse de fonctionner. Entre 1 heure et 365 jours à partir de maintenant. Par défaut, dans 7 jours |
neverExpires | booléen | true garde le lien actif jusqu'à sa révocation. Ne l'envoyez pas avec expiresAt |
Exemple de requête :
{
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3,
"expiresAt": "2026-11-30T18:00:00Z"
}Renvoie 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
}| Champ | Description |
|---|---|
url | La page à envoyer. Toute personne qui l'a peut connecter des comptes à cet espace de travail tant que le lien fonctionne |
token | Identifie le lien. Conservez-le pour révoquer le lien plus tard |
expiresAt | Quand le lien cesse de fonctionner, ou null pour un lien qui n'expire jamais |
name, visibility, allowedPlatforms, maxAccounts | Les réglages avec lesquels le lien a été créé. name et maxAccounts valent null s'ils ne sont pas définis |
Un expiresAt hors limites, ou expiresAt envoyé avec neverExpires, renvoie 400 avec un message qui en donne la raison.
Un lien cesse aussi de fonctionner dès qu'il est révoqué, dès qu'il a connecté maxAccounts comptes, ou quand le membre qui l'a créé ne peut plus gérer les comptes de l'espace de travail.
DELETE /api/v1/connect-links/:token
Révoque le lien immédiatement. Les comptes déjà connectés par ce lien restent connectés. Renvoie { "success": true }, ou 404 si aucun lien de cet espace de travail n'a ce token.