---
title: "Bulk create products"
description: "Use POST /bulks/products to create products in one administrative request."
canonical: https://docs.ordering.co/api-reference/guides/bulk-create-products/
---

# Bulk create products

> **API operation:** [Open the endpoint in the API reference](https://docs.ordering.co/api-reference/#tag/bulks/POST/bulks/products)

Use `POST /bulks/products` to create products in one administrative request. The current public operation is `ProductBulk.register` and requires administrator or business-manager authentication.

The request field `products` carries a JSON-encoded array. Each item requires `name`, `price`, `category_id`, and `business_id` in the operation rules.

```json
{
  "products": "[{\"name\":\"Example product\",\"price\":12,\"category_id\":272,\"business_id\":41}]"
}
```

If available, the operation supports up to 1,000 products across at most five businesses. A business manager can target only owned businesses, and every category must belong to the stated business. The operation validates the collection before creating records; treat any failure as a failed batch and check the response before continuing.

Fields whose names begin with `metafield_` are converted into product metafields during bulk creation. For example, `metafield_color` creates the metafield key `color`. Use only synthetic values in examples and confirm the full request schema in the API reference.

## OpenAPI reference

**Operation:** `POST /bulks/products`

**Request body fields**

| Name       | Type   | Required |
| ---------- | ------ | -------- |
| `products` | string | Yes      |

**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/bulks/POST/bulks/products)
