The Campaign object contains the details of the campaign the advertiser would like to run, along with a list of units. It starts out as a proposal, then moves into a booked state once purchased.
Guaranteed Campaign Collection
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.
query Parameters
pagePage number (1-based)
per_pageNumber of records per page (max 100)
start_dateFilter campaigns with a start date on or after this date (YYYY-MM-DD)
end_dateFilter campaigns with an end date on or before this date (YYYY-MM-DD)
statusFilter by plan status
archivedWhen true, list only archived campaigns (and expose archived_at on each). Defaults to false, which lists only campaigns that have not been archived.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Guaranteed Campaign Collection › Responses
successful
Pagination metadata for paginated responses
Create Guaranteed Campaign Draft
Creates a draft campaign for the authenticated partner. advertiser_id is the AdQuick advertiser id; start_date and end_date are optional.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Create Guaranteed Campaign Draft › Request Body
user_emailCampaign owner email
sales_user_emailSales / Account Executive email
fulfillment_user_emailAccount Manager email
advertiser_idstart_dateend_datetarget_budget_centsTarget budget, in cents
nameCreate Guaranteed Campaign Draft › Responses
draft created
campaign_tokenShow Guaranteed Campaign
Returns a single guaranteed campaign by its token. Archived campaigns are still returned here, carrying the archived_at timestamp.
path Parameters
tokenCampaign token
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Show Guaranteed Campaign › Responses
successful
campaign_tokencampaign_typecampaign_nameadvertiser_iduser_emailCampaign owner email
sales_user_emailSales / Account Executive email
fulfillment_user_emailAccount Manager email
start_dateend_datetarget_budget_centstarget_cpmestimated_impressionsscreen_countavailability_statusgeographiesmedia_typesarchived_atOnly present when the campaign is archived
Archive Guaranteed Campaign
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.
path Parameters
tokenCampaign token
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Archive Guaranteed Campaign › Responses
campaign archived
campaign_tokenarchivedUpdate Guaranteed Campaign
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.
path Parameters
tokenCampaign token
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Update Guaranteed Campaign › Request Body
nameuser_emailReassign the campaign owner by email
sales_user_emailReassign the Sales / Account Executive by email
fulfillment_user_emailReassign the Account Manager by email
target_budget_centsTarget budget, in cents
advertiser_idReassign the campaign to this AdQuick advertiser id
Update Guaranteed Campaign › Responses
campaign updated
campaign_tokencampaign_typecampaign_nameadvertiser_iduser_emailCampaign owner email
sales_user_emailSales / Account Executive email
fulfillment_user_emailAccount Manager email
start_dateend_datetarget_budget_centstarget_cpmestimated_impressionsscreen_countavailability_statusgeographiesmedia_typesarchived_atOnly present when the campaign is archived
Programmatic Campaign Collection
Returns a paginated collection of programmatic campaigns for the authenticated partner. Supports optional filtering by status and date range.
query Parameters
pagePage number (1-based)
per_pageNumber of records per page (max 100)
start_dateFilter campaigns with a start date on or after this date (YYYY-MM-DD)
end_dateFilter campaigns with an end date on or before this date (YYYY-MM-DD)
statusFilter by plan status
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Programmatic Campaign Collection › Responses
successful
Pagination metadata for paginated responses
Show Programmatic Campaign
Returns a single programmatic campaign by its token.
path Parameters
tokenCampaign token
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key.
Show Programmatic Campaign › Responses
successful
campaign_tokencampaign_typecampaign_nameplan_tokenplan_nameadvertiser_idstart_dateend_datetarget_budget_centstarget_cpmestimated_impressionsscreen_countgeographiesmedia_types