# Add Bundle Item

**POST** `/v1/bundles/:listing_id/items`

Adds a component listing to a fixed bundle. Requires admin or bundle owner access.

Sellers can only add their own listings as components. Bundles cannot be nested inside other bundles.

### Path parameters

| Field | Type | Description |
|---|---|---|
| `listing_id` | integer | ID of the bundle listing |

### Request fields

| Field | Type | Required | Description |
|---|---|---|---|
| `component_listing_id` | integer | Yes | ID of the listing to add as a component |
| `quantity` | integer | Yes | Quantity of this component per bundle (min 1) |
| `order_by` | integer | No | Display sort order (default 0) |
| `metadata` | object | No | Arbitrary metadata |

### Response fields

**item** — The created bundle item object.