Skip to content

Update Campaign

PUT
/api/public/campaign/{request_id}

Updates a campaign’s dates, cost, units and other details.

Update Campaign
curl --request PUT \
--url https://backend.podscribe.ai/api/public/campaign/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "type": "Baked-in", "startDate": "2026-04-15T12:00:00Z", "endDate": "2026-04-15T12:00:00Z", "expectedDate": "2026-04-15T12:00:00Z", "totalCost": 1, "cpm": 1, "currency": "USD", "expectedImpressions": 1, "itunesOrYtId": "example", "geo": "GLOBAL", "expectedUnits": [ [ { "position": "pre", "length": 1 } ] ], "promo": "example", "expectedLandingUrl": "https://example.com", "product": "example", "initiative": "example", "mediaType": "podcast", "tags": [ "example" ], "teamMembers": [ "example" ], "creativeIds": [ "example" ] }'
request_id
required
string<uuid>

Campaign ID

Media typeapplication/json
type

Campaign type. Instagram campaigns (mediaType instagram) take story, reel or feed; other media types take DAI or Baked-in.

Allowed values: Baked-in DAI story reel feed
startDate

start of the campaign in ISO format for DAI campaigns

string<date-time>
endDate

end of the campaign in ISO format for DAI campaigns

string<date-time>
expectedDate

expected date in ISO format for Baked-in campaings

string<date-time>
totalCost

Rate of the campaign. When currency is omitted, the amount is read in the stored currency, not USD.

number
cpm

CPM rate of the campaign. When currency is omitted, the amount is read in the stored currency, not USD.

number
currency

Currency code (USD, EUR, GBP). When sent, the exchange rate is calculated automatically. When omitted, the stored currency and exchange rate are left unchanged.

Allowed values: USD EUR GBP
expectedImpressions

expected impressions of the campaign

number
itunesOrYtId

ITunes ID / YouTube Channel ID / YouTube Playlist ID

string
geo

Country

Allowed values: GLOBAL US GB CA AU DE FR MX IE JP ES IN BR IT AR KR SA AE ID EG AT NL DK FI IL NO NZ SE TR RU
25 moreLess
expectedUnits

Expected units of the campaign

Array<Array<{position,length}>>
position
required

Ad position

Allowed values: pre mid post feed drop
length
required

Ad length in seconds

number
promo

The discount code

string
expectedLandingUrl

Expected landing URL of the campaign

string<uri>
product

Product metadata

string
initiative

Initiative metadata

string
mediaType

Media type of the campaign

Allowed values: podcast youtube simulcast streaming sai ott_ctv display video twitter twitch tiktok instagram rumble spotify spotifyvideo dailywire display_video radio radio_show
14 moreLess
tags

Tags

Array<string>
teamMembers

Team members metadata

Array<string>
creativeIds

creative IDs metadata

Array<string>

OK