Ads

Supprimer campagnes, ensembles et annonces Meta Ads via l'API

Trois routes DELETE retirent un objet du compte publicitaire du client : campagne, ensemble ou annonce. Vous utilisez l'id affiché par le Gestionnaire de publicités ou l'uuid Connect, et la connexion du client gère l'accès, sans OAuth à développer ni app review Meta.

L'appel

DELETE /api/ads/campaigns/120250000000000001?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

Ce que vous pouvez faire

  • Supprimer une campagne avec DELETE /ads/campaigns/{id}, qui emporte ses ensembles et annonces, sur la plateforme et dans la base de Connect.
  • Supprimer un ensemble avec DELETE /ads/adsets/{id}, qui emporte ses annonces.
  • Supprimer une annonce avec DELETE /ads/{id}, la campagne et l'ensemble restant en place.
  • Supprimer n'importe quel objet du compte, même créé hors de Connect, avec l'id numérique de la plateforme.
  • Lister aussi les objets supprimés avec include_deleted=true sur source=connect, chacun avec deleted_at.

Règles et limites

  • Supprimer une campagne supprime ses ensembles et annonces. Pour garder l'historique, mettez en pause au lieu de supprimer.
  • La connexion va toujours dans ?customer_integration= et l'appel exige Authorization et x-customer-token.
  • Idempotency-Key est facultatif sur DELETE. Avec lui, répéter l'appel renvoie la première réponse.
  • L'objet doit appartenir au compte de la connexion : un id d'un autre compte répond 404 ads_object_not_found, tout comme un uuid que Connect ne stocke pas.
  • La réponse 200 contient data avec id et deleted. Si la plateforme refuse, son statut est répercuté et integration_error porte le code.

Champs principaux

ChampTypeObligatoireDescription
idstringOuiDans /ads/campaigns/{id}, /ads/adsets/{id} ou /ads/{id} : l'id numérique de l'objet sur la plateforme publicitaire (le même que dans le Gestionnaire de publicités) ou l'uuid Connect.
customer_integrationstringOuiL'uuid de la connexion du client. Il définit le compte publicitaire. Toujours dans la query.
Idempotency-KeystringNonHeader facultatif ici (255 caractères maximum). Avec lui, répéter l'appel renvoie la première réponse au lieu de supprimer à nouveau.
deletedbooleanNonDans la réponse, sous data : confirme que l'objet a été supprimé, avec son id.

Pour qui

  • Nettoyer les campagnes brouillon

    Une plateforme de gestion de trafic supprime en un clic les campagnes de test créées par erreur, sans que le client ouvre le Gestionnaire de publicités.

  • Agent IA qui range les comptes

    Un agent repère les annonces refusées et supprime uniquement celles-ci, en gardant l'ensemble et la campagne pour de nouveaux visuels.

  • Terminer une promotion client

    Une agence termine une promotion en supprimant la campagne, et ses ensembles et annonces partent avec elle en un seul appel.

Fonctionne avec

  • Meta Ads

Questions fréquentes

Supprimer une campagne supprime-t-il ses annonces ?

Oui. DELETE /ads/campaigns/{id} emporte les ensembles et annonces, sur la plateforme et dans la base de Connect. Supprimer un ensemble emporte ses annonces, et supprimer une annonce laisse l'ensemble et la campagne.

Peut-on revoir ce qui a été supprimé ?

Oui. Sur les listes avec source=connect, include_deleted=true inclut les objets supprimés, chacun avec deleted_at. Sans ce paramètre, ils n'apparaissent pas.

Peut-on supprimer un objet créé hors de Connect ?

Oui. L'id accepté est l'id numérique de la plateforme, valable pour tout objet du compte. Il n'est refusé (404) que si l'objet appartient à un autre compte.

Voir aussi

Voir tout ce que vous pouvez faire avec Ads

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.