OTotto
SponsoredProductAds V1

Create campaign

Changed on

Creates a campaign.

post/v1/sponsored-product-ads/campaigns

Request

  • Base URL
    https://api.otto.market
  • URL
    https://api.otto.market/v1/sponsored-product-ads/campaigns
  • Auth
    HTTP bearer

Request body

namestring required

Campaign display name. Must not contain $, §, ", #, *, or parentheses — except for an optional trailing numeric suffix (e.g. My campaign (2)).

startDatestring date required

Campaign start date. Must be today or a future date.

endDatestring date nullable

Campaign end date. Must be at least today and greater or equal to the startDate. May be null for ongoing campaigns; however, null is not allowed when budgetType is LIFETIME.

pacing'ASAP' | 'EVEN' required
budgetType'DAILY' | 'WEEKLY' | 'MONTHLY' | 'LIFETIME' required
campaignType'AUTOMATIC' | 'MANUAL' required

Example request

{
  "name": "My awesome campaign",
  "startDate": "2026-04-28",
  "endDate": "2026-10-28"
}

Response

Campaign creation accepted.

Example response

{
  "_links": {
    "self": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/campaigns"
    },
    "change-request": {
      "href": "https://api.otto.market/v1/sponsored-product-ads/change-requests/00000004-0000-4000-8000-000000000004"
    }
  }
}

Changes