Skip to main content
Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.
POST /api/v2/buyer/campaigns/{campaignId}/creative-sessions Starts a reviewable creative session and returns draft variants for the campaign. Use the session to compare directions, refine one, evaluate it, and finalize the approved output as a campaign Creative.

Request

For an AudioStack session, set language when the buyer specifies the spoken language. It generates the script and AudioStack speech in that language; it is not a translation request for other creative modalities.
Returns 201 Created with the creative session, including its draft variants and creative plan.

Meta platform preview (internal testing only)

POST /api/v2/buyer/campaigns/{campaignId}/creative-sessions/{sessionId}/variants/{variantId}/platform-previews Send { "placement": "facebook_feed" } or { "placement": "instagram_feed" } to render an unsaved Meta image-post draft through the buyer’s connected Meta account. The response returns one platform_previews entry with either a trusted Meta URL and expiry time, or an unavailable reason. This endpoint is currently limited to Apostra internal test accounts. Other accounts receive preview_not_enabled_for_account and their draft is not sent to Meta. The endpoint creates no Meta objects or spend. It caches an identical draft and placement and allows at most 30 fresh previews per Meta ad account each hour.

What a Meta preview sends

When this internal-only preview is enabled for an account, Apostra sends Meta a read-only request through that buyer’s own Meta connection. It includes the selected ad account and requested placement, plus the creative manifest: format metadata, the brand reference, the Page (and Instagram identity for an Instagram preview), the draft’s primary text, headline, description, call to action and landing URL, and a link to the draft image. Meta fetches that image from the link. A generated variant sends its generated image’s link. A composer draft sends a signed read of the chosen Library image, made for that preview after the account and advertiser are checked, which expires after 15 minutes. The request does not create a creative, ad, image, or campaign, and it does not spend money or publish anything. The same creative is sent to Meta when the buyer later chooses to run it. Apostra documents what it sends; it does not claim what Meta retains after receiving those inputs. Unavailable responses use these closed reasons: preview_not_enabled_for_account, placement_not_supported, not_connected, page_not_authorized, instagram_identity_missing, asset_not_public, meta_rate_limited, meta_unavailable, preview_service_unavailable, hourly_limit_reached, and unexpected_link.