Campaigns

Create Placement

Record a creator's paid slot in this campaign.

A placement may be created with no amount and no video: a deal agreed but neither paid nor published is a real state, and the operator wants it on the board rather than in their head.

post/api/campaigns/{campaign_id}/placements

Request

  • Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.kolens.ai/api/campaigns/{campaign_id}/placements
  • Auth: HTTP bearer

Path parameters

campaign_idstring required

Headers

x-kolens-user-idstring nullable
x-kolens-workspace-idstring nullable

Request body

kol_usernamestring required
kol_platformstring
amountnumber nullable
currencystring nullable
fx_rate_to_campaignnumber nullable

Rate to the campaign's currency, frozen at entry. Required only when the placement currency differs.

statusstring
paid_onstring date-time nullable
notestring nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.