Promote a Post

POST /v1/ads/boost promotes a Reddit post that already exists, keeping its votes and comments.

Pass platformPostId (the Reddit post id, with or without the t3_ prefix), or a Zernio postId published by a Reddit account connected to the same profile.

Promote an existing post

const { data: boosted } = await zernio.adcampaigns.boostPost({
  body: {
    accountId: '66b2e19d8c3f5a7e9d0b1c2d',
    adAccountId: 'a2_gu5tcd9ah5se',
    platformPostId: 't3_1o4x9qz',
    name: 'Boost launch thread',
    goal: 'traffic',
    budget: { amount: 30, type: 'daily' },
    linkUrl: 'https://example.com/planner',
    targeting: { countries: ['US'], communities: ['productivity'] }
  }
});

console.log(boosted.ad.id);

Response (201):

{
  "ad": {
    "id": "66f0a1b2c3d4e5f6a7b8c9d1",
    "name": "Boost launch thread",
    "platform": "reddit",
    "status": "pending_review",
    "adType": "boost",
    "goal": "traffic",
    "budget": { "amount": 30, "type": "daily" }
  },
  "message": "Ad created and submitted for review"
}

Boosts are not idempotent. Send an Idempotency-Key header to make a retry replay the original 201 instead of creating a second ad (idempotency).

How it behaves

• Reddit only promotes posts made by a profile of the ad account: a post by any other Reddit user returns 422 with param: "platformPostId". Link the author to the ad account in Reddit Ads Manager first.
• Goals, pixel, budget and schedule and targeting work as on a create, with targeting inside the targeting object.
• video_views needs a video post.
• linkUrl is optional and sets the ad's click URL.

Related

• Boost post: every field of the request.