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

Synchroniser les comptes publicitaires

Force une nouvelle récupération immédiate des comptes publicitaires d'un compte connecté depuis la plateforme, au lieu d'attendre la synchronisation quotidienne en arrière-plan. Renvoie la liste actualisée.

post/api/v1/connections/ad-accounts/sync
connections:write
Corps de la requête
connectionIdstringobligatoire
Le compte connecté à synchroniser. 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.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/connections/ad-accounts/sync
Votre clé API
Corps de la requête*
{
  "data": {
    "adAccounts": [
      {
        "id": "adacct_1",
        "connectionId": "conn_1",
        "platformAccountId": "act_549988676430053",
        "name": "Acme Dental Ads",
        "platform": "facebook",
        "status": "active",
        "isSelected": false,
        "currency": "USD",
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-02-01T09:00:00.000Z"
      }
    ]
  }
}