Promote an Existing Pin
Promote a Pin you already published with POST /v1/ads/boost, keeping its engagement.
POST /v1/ads/boost promotes a Pin that is already published, keeping its engagement. Pass the Zernio postId (or the Pinterest platformPostId), the account, the ad account, a goal and a budget.
const { data: boosted } = await zernio.adcampaigns.boostPost({
body: {
postId: '65f1c0a9e2b5af0012ab34cd',
accountId: '66b2e19d8c3f5a7e9d0b1c2d',
adAccountId: '549123456789',
name: 'Boost decor Pin',
goal: 'traffic',
budget: { amount: 30, type: 'daily' },
schedule: { startDate: '2027-01-04T09:00:00Z', endDate: '2027-02-04T23:59:00Z' }
}
});
console.log(boosted.ad._id);Response (201):
{
"ad": {
"_id": "66f0a1b2c3d4e5f6a7b8c9d1",
"name": "Boost decor Pin",
"platform": "pinterest",
"status": "pending_review",
"adType": "boost",
"goal": "traffic",
"budget": { "amount": 30, "type": "daily" }
},
"message": "Ad created"
}Boosts are not idempotent. Send an Idempotency-Key header to make a retry replay the original 201 instead of creating a second ad (idempotency).
Was this page helpful?