---
title: "Create Product Gallery Item"
description: "Use POST /business/{business_id}/categories/{category_id}/products/{product_id}/gallery to add an item to a product gallery."
canonical: https://docs.ordering.co/api-reference/guides/create-product-gallery-item/
---

# Create Product Gallery Item

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/business/POST/business/{business_id}/categories/{category_id}/products/{product_id}/gallery)

Use `POST /business/{business_id}/categories/{category_id}/products/{product_id}/gallery` to add an item to a product gallery. The operation documented here is `ProductGallery.register`.

The documented schema restricts creation to administrators and business managers. Business-manager access is scoped through the product's business.

The request schema describes image and video gallery items: type `1` requires `file`, while type `2` requires a valid `video` URL. Optional `title` and `description` fields provide item details.

## OpenAPI reference

**Operation:** `POST /business/{business_id}/categories/{category_id}/products/{product_id}/gallery`

**Path parameters**

| Name          | Type    | Required | Description |
| ------------- | ------- | -------- | ----------- |
| `business_id` | integer | Yes      | —           |
| `category_id` | integer | Yes      | —           |
| `product_id`  | integer | Yes      | —           |

**Request body fields**

| Name          | Type    | Required |
| ------------- | ------- | -------- |
| `description` | any     | No       |
| `file`        | any     | No       |
| `product_id`  | integer | Yes      |
| `title`       | any     | No       |
| `type`        | integer | Yes      |
| `video`       | any     | No       |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK (Envelope)                         |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/business/POST/business/{business_id}/categories/{category_id}/products/{product_id}/gallery)