Managing ad campaigns through the Marketing API involves several key operations: modifying campaign settings, pausing and resuming campaigns, and deleting campaigns.
To update an existing ad campaign, you can send a POST
request to the /<CAMPAIGN_ID>
endpoint. You can change various settings, including the campaign's objective, budget, and targeting attributes.
Example API Request:
curl -X POST \
https://graph.facebook.com/v21.0
/<CAMPAIGN_ID> \
-F 'objective=CONVERSIONS' \
-F 'daily_budget=2000' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>'
Temporarily stopping a campaign can help you reassess your strategy without deleting the campaign entirely. To pause a campaign, update its status to PAUSED
.
Example API Request:
curl -X POST \
https://graph.facebook.com/v21.0
/<CAMPAIGN_ID> \
-F 'status=PAUSED' \
-F 'access_token=<ACCESS_TOKEN>'
To resume the campaign, you can set the status back to ACTIVE
.
If you want to temporarily stop a campaign without deleting it, you can archive it instead. To do this, send a POST
request to the /<CAMPAIGN_ID>
endpoint with the status parameter set to ARCHIVED
.
Example API Request
curl -X POST \
https://graph.facebook.com/v21.0
/<CAMPAIGN_ID> \
-F 'status=ARCHIVED \
-F 'access_token=<ACCESS_TOKEN>'
Note that archiving a campaign will stop it from running, but it can be easily restored by changing its status back to ACTIVE
.
When you need to permanently remove a campaign, send a DELETE
request to the /<CAMPAIGN_ID>
endpoint.
Be cautious when deleting campaigns, as this action cannot be undone. Always double-check the campaign ID before deletion to avoid accidental loss of data.
Example API Request
curl -X DELETE \
https://graph.facebook.com/v21.0
/<CAMPAIGN_ID> \
-F 'access_token=<ACCESS_TOKEN>'