---
title: "Create a new bundle with the provided information."
method: POST
path: "/v1/bundles"
tags: ["Assets", "Avatars"]
---

# Create a new bundle with the provided information.

`POST /v1/bundles`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/bundles`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Request body

- RobloxItemConfigurationApiModelsRequestBundleCreateBundleRequest: DTO of incoming request from the client to create a bundle.
  - `bundleType` 'Unknown' | 'Body' | 'DynamicHead' | 'Shoes' | 'AvatarAnimations': The bundle type target for the bundle creation. ['Unknown' = 0, 'Body' = 1, 'DynamicHead' = 2, 'Shoes' = 3, 'AvatarAnimations' = 4]
  - `name` string: Name of the bundle to be created.
  - `description` string: Description of the bundle.
  - `assetIds` integer[]: List of asset ids which are to be part of this bundle. These asset ids must include only the allowed asset types for the particular bundle type that is being created.
  - `operationId` string: Operation ID of the original intent that was created to start bundle creation.
  - `agreedCreationFee` integer: Fee in Robux to create bundle. It needs to be the same as the actual price on the upload fee product entity. Otherwise, the bundle will fail to be created.

## Response `200`

OK

- RobloxItemConfigurationApiModelsResponseBundleCreateBundleResponse: DTO response for the create bundle request.
  - `creationStatusId` string: ID associated with the corresponding create bundle request. This ID is used to query for bundle creation status endpoint.

## Other responses

- `400`: 2: Invalid Bundle Name 3: Invalid AssetIds 4: Invalid OperationId 5: Invalid Bundle Type 6: Invalid/Null Create Bundle Request 7: Invalid Bundle Description 11: Group Creator Not Supported 13: Creation fee is invalid, must be a positive number
- `401`: 0: Authorization has been denied for this request.
- `403`: 0: Token Validation Failed 9: Item is not allowed to be part of a new bundle 12: Creator mismatch
- `412`: 10: Invalid Bundle Creation State
- `501`: 8: Unsupported Bundle Type
- `503`: 1: Service Unavailable

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/bundles/post.md)

---

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