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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| id | string | Oui | Dans /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_integration | string | Oui | L'uuid de la connexion du client. Il définit le compte publicitaire. Toujours dans la query. |
| Idempotency-Key | string | Non | Header facultatif ici (255 caractères maximum). Avec lui, répéter l'appel renvoie la première réponse au lieu de supprimer à nouveau. |
| deleted | boolean | Non | Dans 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
