> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /2025-10/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.



## OpenAPI

````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json post /2025-10/marketing-solutions/marketplace-performance-outcomes/budgets
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2025-10
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2025-10/marketing-solutions/marketplace-performance-outcomes/budgets:
    post:
      tags:
        - Campaign
      summary: /2025-10/marketing-solutions/marketplace-performance-outcomes/budgets
      description: "Create one or more new budgets to enable spending with the given limitations.\r\nAll three types of budgets can be created this way.\r\n            \r\nThe following constraints apply when creating a new budget.\r\n            \r\n• <b>sellerId</b>: the seller MUST be supplied<br />\r\n• <b>campaignIds</b>: a non-empty array of campaign ids MUST be supplied<br />\r\n• <b>budgetType</b>: a budget type MUST be supplied<br />\r\n• <b>amount</b>: an amount MAY be supplied only if the type is not Uncapped and if supplied it MUST be non-negative<br />\r\n• <b>startDate</b>: a future start date MUST be supplied<br />\r\n• <b>endDate</b>: an end date MAY be supplied and if supplied MUST be greater than the start date<br />\r\n            \r\nOther attributes MUST NOT be supplied."
      operationId: CreateMarketplaceSellerBudgets
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/CreateSellerBudgetMapiMessage'
        required: true
        x-bodyName: createSellerBudgets
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SellerBudgetMessage'
      security:
        - oauth:
            - MarketingSolutions_Campaign_Manage
components:
  schemas:
    CreateSellerBudgetMapiMessage:
      type: object
      properties:
        amount:
          type: string
          description: Budget amount as a string (e.g. '100.50')
        budgetType:
          type: string
          description: >-
            Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed
            amount), or 'Uncapped' (lifetime with no limit)
        campaignIds:
          type: array
          items:
            type: integer
            format: int32
          description: List of campaign IDs this budget applies to
        endDate:
          type: string
          description: >-
            Budget end date as a string (format: YYYY-MM-DD), or empty string
            for open-ended
        sellerId:
          type: string
          description: Identifier of the seller this budget is for
        startDate:
          type: string
          description: Budget start date. Time component is ignored.
          format: date-time
      description: Data used to create a seller's budget
    SellerBudgetMessage:
      type: object
      properties:
        amount:
          type: number
          description: Budget amount in the advertiser's currency
          format: double
          nullable: true
        budgetType:
          type: string
          description: >-
            Type of budget: 'Daily' (daily cap), 'Capped' (lifetime with fixed
            amount), or 'Uncapped' (lifetime with no limit)
        campaignIds:
          type: array
          items:
            type: integer
            format: int32
          description: List of campaign IDs this budget applies to
        endDate:
          type: string
          description: >-
            End date of the budget period (format: YYYY-MM-DD), or empty string
            if open-ended
        id:
          type: string
          description: Unique budget identifier
        isSuspended:
          type: boolean
          description: Whether the budget has been manually suspended by the partner
        sellerId:
          type: string
          description: Identifier of the seller this budget belongs to
        spend:
          type: number
          description: Amount spent against this budget so far, or null if not available
          format: double
          nullable: true
        startDate:
          type: string
          description: 'Start date of the budget period (format: YYYY-MM-DD)'
          format: date
        status:
          $ref: '#/components/schemas/SellerBudgetStatusV2'
      description: >-
        A budget defines spending constraints for a seller across one or more
        campaigns. Each seller can have one active budget per time period.
      example:
        id: '16501666'
        sellerId: '10656107'
        campaignIds:
          - 436017
        budgetType: Capped
        amount: 462.47
        endDate: '2026-04-30'
        spend: 117.59
        status: Current
        isSuspended: false
    SellerBudgetStatusV2:
      enum:
        - Archived
        - Current
        - Scheduled
      type: string
      description: Status of a seller budget
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}

````