---
title: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets"
method: POST
path: "/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets"
tags: ["Campaign"]
---

# /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets

`POST /2026-01/marketing-solutions/marketplace-performance-outcomes/budgets`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/marketing-solutions/marketplace-performance-outcomes/budgets`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `MarketingSolutions_Campaign_Manage`

Create one or more new budgets to enable spending with the given limitations.
All three types of budgets can be created this way.
            
The following constraints apply when creating a new budget.
            
• <b>sellerId</b>: the seller MUST be supplied<br />
• <b>campaignIds</b>: a non-empty array of campaign ids MUST be supplied<br />
• <b>budgetType</b>: a budget type MUST be supplied<br />
• <b>amount</b>: an amount MAY be supplied only if the type is not Uncapped and if supplied it MUST be non-negative<br />
• <b>startDate</b>: a future start date MUST be supplied<br />
• <b>endDate</b>: an end date MAY be supplied and if supplied MUST be greater than the start date<br />
            
Other attributes MUST NOT be supplied.

## Request body

- CreateSellerBudgetMapiMessage[]
  - `amount` string: Budget amount as a string (e.g. '100.50')
  - `budgetType` string: Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed amount), or 'Uncapped' (lifetime with no limit)
  - `campaignIds` integer[]: List of campaign IDs this budget applies to
  - `endDate` string: Budget end date as a string (format: YYYY-MM-DD), or empty string for open-ended
  - `sellerId` string: Identifier of the seller this budget is for
  - `startDate` string, date-time: Budget start date. Time component is ignored.

## Response `200`

Success

- SellerBudgetMessage[]
  - `amount` number, double, nullable: Budget amount in the advertiser's currency
  - `budgetType` string: Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed amount), or 'Uncapped' (lifetime with no limit)
  - `campaignIds` integer[]: List of campaign IDs this budget applies to
  - `endDate` string: End date of the budget period (format: YYYY-MM-DD), or empty string if open-ended
  - `id` string: Unique budget identifier
  - `isSuspended` boolean: Whether the budget has been manually suspended by the partner
  - `sellerId` string: Identifier of the seller this budget belongs to
  - `spend` number, double, nullable: Amount spent against this budget so far, or null if not available
  - `startDate` string, date: Start date of the budget period (format: YYYY-MM-DD)
  - `status` 'Archived' | 'Current' | 'Scheduled': Status of a seller budget

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)