Synupv1
Créer une clé
v1Ressources/Connexions/getLister les comptes publicitaires

Lister les comptes publicitaires

Renvoie les comptes publicitaires payants disponibles sur un compte connecté (Facebook, Instagram, LinkedIn ou TikTok).

get/api/v1/connections/ad-accounts
connections:read
Paramètres de requête
connectionIdstringobligatoire
Le compte connecté à consulter. Obligatoire. Retrouvez-le avec GET /api/v1/connections.
Réponse
dataobjectfacultatif
adAccountsarray of objectfacultatif
Les comptes publicitaires disponibles sur ce compte connecté.
idstringfacultatif
Identifiant unique du compte publicitaire.
connectionIdstringfacultatif
ID du compte connecté auquel appartient ce compte publicitaire.
platformAccountIdstringfacultatif
L'identifiant propre à la plateforme pour ce compte publicitaire, par ex. act_226123609900306 pour Meta.
namestringfacultatif
Nom d'affichage du compte publicitaire.
platformstringfacultatif
Plateforme à laquelle appartient ce compte publicitaire : facebook, instagram, linkedin ou tiktok.
statusstring (active | disabled | unsettled | pending_review)facultatif
Statut signalé par la plateforme : active, disabled, unsettled ou pending_review.
isSelectedbooleanfacultatif
Si c'est le compte publicitaire actuellement sélectionné pour le boost sur cette connexion.
currencystringfacultatif
Devise de facturation de ce compte publicitaire, ou null.
archivedbooleanfacultatif
Si ce compte publicitaire a été archivé.
createdAtstringfacultatif
Date de première synchronisation de ce compte publicitaire, au format horodatage ISO 8601.
updatedAtstringfacultatif
Date de dernière synchronisation de ce compte publicitaire, au format horodatage ISO 8601.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/connections/ad-accounts
Votre clé API
connectionId *
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": true,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}