Ads · Ad Campaigns
Pauses or resumes many campaigns.
POST
https://api.pozy.ai/v1/ads/campaigns/bulk-statusFacebook and Instagram, Google Workspace, TikTok, LinkedIn, Pinterest and X and 1 morebulkUpdateAdCampaignStatus
Guide: Meta Ads
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the ads resource group disabled get 403 resource_group_disabled. Authentication
Request body
application/json, required
statusstringrequiredOne of
active,paused.campaignsarray of objectrequiredUp to 50 items.
platformCampaignIdstringrequiredplatformstringrequiredOne of
facebook,instagram,tiktok,linkedin,pinterest,google,twitter,openai,reddit,googleads,tiktokads,linkedinads,pinterestads,xads,openaiads,redditads.
Example
curl -X POST "https://api.pozy.ai/v1/ads/campaigns/bulk-status" \
-H "Authorization: Bearer $POZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"status": "active",
"campaigns": [
{
"platformCampaignId": "68f1e8569b986839e821d8ba",
"platform": "facebook"
}
]
}'const res = await fetch("https://api.pozy.ai/v1/ads/campaigns/bulk-status", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.POZY_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
status: "active",
campaigns: [
{
platformCampaignId: "68f1e8569b986839e821d8ba",
platform: "facebook"
}
]
}),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.post(
"https://api.pozy.ai/v1/ads/campaigns/bulk-status",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
json={
"status": "active",
"campaigns": [
{
"platformCampaignId": "68f1e8569b986839e821d8ba",
"platform": "facebook",
},
],
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
statusstringOne of
active,paused.totalsobjectupdatedintegerskippedintegerfailedinteger
resultsarray of objectplatformCampaignIdstringplatformstringupdatedintegerOne of
0,1.skippedintegerOne of
0,1.platformCampaignStatusstringCan be null.
errorstring
200 response
{
"status": "active",
"totals": {
"updated": 1,
"skipped": 1,
"failed": 1
},
"results": [
{
"platformCampaignId": "68f1e8569b986839e821d8ba",
"platform": "instagram",
"updated": 0,
"skipped": 0,
"platformCampaignStatus": "instagram",
"error": "string"
}
]
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is read-only, scoped to other profiles, or has this resource group disabled. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in Ad Campaigns
GETList adsGETList Google Ads recommendationsPOSTApply Google Ads recommendationsPOSTDismiss Google Ads recommendationsGETList portfolio bid strategiesPOSTCreate portfolio bid strategyPATCHUpdate portfolio bid strategyGETList shared budgetsPOSTCreate a shared budgetGETList Search keywordsPOSTAdd Search ad-group keywordsPATCHPause or enable a Search keywordDELRemove a Search keywordGETList campaignsPOSTCreate a standalone campaignPUTPause or resume a campaignGETRead a campaign's ad schedule (dayparting)PUTReplace a campaign's ad schedule (dayparting)GETRead a campaign's current biddingGETGet live campaign detailsPUTUpdate a campaignDELDelete a campaignGETList campaign-level negative keywordsPUTReplace campaign-level negative keywordsPOSTDuplicate a campaignGETRead a Google campaign's device, location, excluded location, and language targetingPUTEdit a Google campaign's device, location, excluded location, or language targetingGETList ad setsPOSTCreate a standalone ad groupPOSTDuplicate an ad setPOSTDuplicate an adGETGet live ad-set detailsPUTUpdate an ad setDELDelete an ad setGETRead a Reddit ad group's targeting and schedulePUTPause or resume a single ad setGETGet campaign treeGETGet daily account metricsGETGet ad detailsPUTUpdate adDELCancel an adPUTPause or resume a single adGETList campaign assetsPOSTAttach campaign assetsPUTUpdate campaign assetsDELRemove campaign assetsGETList ad-group assetsPOSTAttach ad-group assetsPUTUpdate ad-group assetsDELRemove ad-group assetsGETRead the platform's review verdict for an adGETReview status of each creative in a TikTok Smart+ adGETList ads that need attentionPOSTDismiss an ads alertGETReview status of every TikTok Smart+ ad of an advertiserGETList campaign negative listsPUTReplace campaign negative listsPOSTBoost post as adGETList Performance Max asset groupsPOSTCreate a Performance Max asset groupGETGet a Performance Max asset groupPATCHUpdate a Performance Max asset groupDELRemove a Performance Max asset groupPOSTLink or unlink asset group assetsPUTReplace an asset group's listing-group treePOSTCreate standalone adGETGet campaign conversion goalsPATCHUpdate campaign conversion goals