---
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`

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.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)