Campaigns

Returns how far the campaign's automatic avails requests have got. Poll it after you create a campaign.

It covers the supplier avails requests (the supplier APIs and the managed vendors) only. It does not include manual RFPs and has no timeout, so it can differ from the campaign's availability_status.

Returns a paginated collection of guaranteed campaigns for the authenticated partner. Supports optional filtering by status and date range. Archived campaigns are left out; pass archived=true to list those instead, each with its archived_at.

Creates a campaign for the authenticated partner. advertiser_id is the AdQuick advertiser id; start_date and end_date are optional. campaign_name is an alias of name, and the two may not disagree. A campaign with start_date, end_date and location_ids starts to request unit availability from suppliers; availability_status on show reports the progress.

Returns a single guaranteed campaign by its token. Archived campaigns are still returned here, carrying the archived_at timestamp.

Archives a guaranteed campaign: it leaves the default collection (list it with archived=true) and archiving it again returns 404, while show keeps returning it with archived_at set. Its units are preserved, and the campaign itself is only soft-deleted, so AdQuick can still restore it.

Partially updates a guaranteed campaign. Every field is optional; only the fields present in the body are changed. target_budget_cents is in cents. advertiser_id is refused for a partner whose organization is the advertiser — their campaigns are scoped by it. campaign_name is an alias of name, and the two may not disagree. An empty fulfillment_user_email clears the account manager (refused once the campaign is booked); the three *_user_email fields refuse null, so omit a key to leave that field alone.

Returns a paginated collection of programmatic campaigns for the authenticated partner. Supports optional filtering by status and date range.

Returns a single programmatic campaign by its token.