Ads

Create a paused Meta boost after approval

Create a Meta boost for one published post from ads.meta.boosts.list_posts: a post engagement campaign, ad set and ad, all paused. The first request creates nothing: it returns approvalRequired with an approval and its reviewUrl. Give the reviewUrl to the person; only their approval there, signed in to Maeve, lets the same request continue. Opening the page approves nothing. Then send the same request again, with the same idempotencyKey, plus approvalId. A repeat of a key that already created returns what it created without asking again. It does not start delivery; activate it with ads.meta.boosts.activate once it is paused and ready.

post/v1/workspaces/{workspaceId}/ads/meta/{accountId}/boosts

Request

  • Base URL: https://api.maevesocial.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maevesocial.com/v1/workspaces/{workspaceId}/ads/meta/{accountId}/boosts
  • Auth: HTTP bearer

Path parameters

accountIdstring required

Ad account UUID from the accounts list.

workspaceIdstring uuid required

Workspace UUID.

Request body

contentIdstring uuid required

Content ID from ads.meta.boosts.list_posts.

objective'POST_ENGAGEMENT' required
optimizationGoal'POST_ENGAGEMENT' required
budgetKind'daily' | 'lifetime' required
budgetMicrosstring required

Whole micros of the account currency as a decimal string: 1000000 is one currency unit.

startAtstring required
endAtstring required
countryCodesstring[]

Two-letter country codes, such as NZ. Any country Meta serves; ads.meta.boosts.get_config suggests some. Give at least one country here or one place in locations.

ageMininteger required
ageMaxinteger required
gender'all' | 'female' | 'male' required
idempotencyKeystring required

A key you choose once for this creation and send unchanged on every repeat, including after the approval. The same key never creates twice.

approvalIdstring uuid

The approval from the first response, sent after the person has approved it in Maeve.

chatConfirmationstring

Only when the workspace lets people approve paid ad creation in chat: the chatConfirmation text from the approval response, sent with its approvalId after the person agreed in this chat. Never send it before they agree.

Response

Create a paused Meta boost after approval

metaunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.