---
updatedAt: 2026-08-13T23:51:37.000Z
---

# Bulk create deals

Create multiple deals in a single request.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Core API Resources",
    "version": "2.0.0",
    "description": "Buzz API v2"
  },
  "paths": {
    "/deals/bulk": {
      "post": {
        "operationId": "deals_bulk_create",
        "description": "Create multiple deals in a single request.",
        "summary": "Bulk create deals",
        "parameters": [
          {
            "name": "order",
            "required": false,
            "in": "query",
            "description": "Which field to use when ordering the results.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Deals"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Deal"
                }
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Deal"
                }
              }
            },
            "multipart/form-data": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Deal"
                }
              }
            }
          },
          "required": true
        },
        "security": [
          {
            "nestSessionAuth": []
          },
          {
            "nestBasicAuth": []
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedDealList"
                }
              }
            },
            "description": ""
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Deal": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "readOnly": true
          },
          "inventory_source_key": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "readOnly": true
          },
          "archived": {
            "type": "boolean",
            "default": true,
            "description": "Archived deals cannot be selected for targeting"
          },
          "source_location": {
            "nullable": true,
            "description": "One of: `\"single_addition\"`, `\"list_entry\"`, `\"targeting\"`, `\"modifier\"`\n\n* `single_addition` - Single Addition\n* `list_entry` - List Entry\n* `targeting` - Targeting\n* `modifier` - Modifier",
            "oneOf": [
              {
                "$ref": "#/components/schemas/SourceLocationEnum"
              },
              {
                "$ref": "#/components/schemas/NullEnum"
              }
            ]
          },
          "cpm_override": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$",
            "nullable": true
          },
          "floor_price": {
            "type": "string",
            "format": "decimal",
            "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$",
            "nullable": true
          },
          "create_date": {
            "type": "string",
            "nullable": true,
            "description": "The date and time the object was first created",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "update_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was last updated",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "start_date": {
            "type": "string",
            "nullable": true,
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "end_date": {
            "type": "string",
            "nullable": true,
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "alternative_id": {
            "type": "string",
            "nullable": true,
            "description": "An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.",
            "maxLength": 200
          },
          "notes": {
            "type": "string",
            "nullable": true,
            "description": "Free-form notes of up to 255 characters.",
            "maxLength": 255
          },
          "deal_format": {
            "nullable": true,
            "description": "One of: `\"banner\"`, `\"video\"`, `\"native\"`, `\"audio\"`\n\n* `banner` - Banner\n* `video` - Video\n* `native` - Native\n* `audio` - Audio",
            "oneOf": [
              {
                "$ref": "#/components/schemas/DealFormatEnum"
              },
              {
                "$ref": "#/components/schemas/NullEnum"
              }
            ]
          },
          "deal_type": {
            "nullable": true,
            "description": "One of: `\"open_auction\"`, `\"private_auction\"`, `\"preferred\"`, `\"guaranteed\"`, `\"advanced\"`\n\n* `open_auction` - Open Auction\n* `private_auction` - Private Auction\n* `preferred` - Preferred\n* `guaranteed` - Guaranteed\n* `advanced` - Advanced",
            "oneOf": [
              {
                "$ref": "#/components/schemas/DealTypeEnum"
              },
              {
                "$ref": "#/components/schemas/NullEnum"
              }
            ]
          },
          "name": {
            "type": "string",
            "maxLength": 255
          },
          "publisher": {
            "type": "string",
            "nullable": true,
            "maxLength": 191
          },
          "deal_id": {
            "type": "string",
            "description": "The supply-side deal identifier",
            "maxLength": 191
          },
          "account_id": {
            "type": "integer",
            "description": "Defaults to the account in the active session"
          },
          "currency": {
            "type": "string",
            "description": "Currency in which floor_price and cpm_override are expressed"
          },
          "advertiser_id": {
            "type": "integer",
            "nullable": true
          }
        },
        "required": [
          "account_id",
          "deal_id",
          "id",
          "inventory_source_key",
          "name",
          "source",
          "update_date"
        ]
      },
      "DealFormatEnum": {
        "enum": [
          "banner",
          "video",
          "native",
          "audio"
        ],
        "type": "string",
        "description": "* `banner` - Banner\n* `video` - Video\n* `native` - Native\n* `audio` - Audio"
      },
      "DealTypeEnum": {
        "enum": [
          "open_auction",
          "private_auction",
          "preferred",
          "guaranteed",
          "advanced"
        ],
        "type": "string",
        "description": "* `open_auction` - Open Auction\n* `private_auction` - Private Auction\n* `preferred` - Preferred\n* `guaranteed` - Guaranteed\n* `advanced` - Advanced"
      },
      "NullEnum": {
        "enum": [
          null
        ]
      },
      "PaginatedDealList": {
        "type": "object",
        "required": [
          "count",
          "results"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "example": 123
          },
          "next": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?page=4"
          },
          "previous": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?page=2"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Deal"
            }
          }
        }
      },
      "SourceLocationEnum": {
        "enum": [
          "single_addition",
          "list_entry",
          "targeting",
          "modifier"
        ],
        "type": "string",
        "description": "* `single_addition` - Single Addition\n* `list_entry` - List Entry\n* `targeting` - Targeting\n* `modifier` - Modifier"
      }
    },
    "securitySchemes": {
      "nestBasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      },
      "nestSessionAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      }
    }
  },
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "node",
    "ruby",
    "javascript",
    "python",
    "php",
    "java"
  ],
  "servers": [
    {
      "url": "https://{buzz_key}.api.beeswax.com/rest/v2",
      "variables": {
        "buzz_key": {
          "default": "stingersbx",
          "description": "Unique customer ID assigned by the Beeswax"
        }
      }
    }
  ],
  "x-readme": {
    "apply-endpoint-order": true,
    "apply-tag-changes": true
  }
}
```