Create categories in batch | Brevo API Documentation

Create or update multiple ecommerce categories in a single request. The `categories` array accepts up to 100 category objects, each requiring a unique `id`. When `updateEnabled` is `false` (the default), all categories are inserted as new; if any ID already exists, a `400` error is returned. When `updateEnabled` is `true`, existing categories are updated and new ones are created via upsert. Duplicate IDs within the same request payload are rejected. The response returns the count of created and updated categories.

Create or update multiple ecommerce categories in a single request. The categories array accepts up to 100 category objects, each requiring a unique id. When updateEnabled is false (the default), all categories are inserted as new; if any ID already exists, a 400 error is returned. When updateEnabled is true, existing categories are updated and new ones are created via upsert. Duplicate IDs within the same request payload are rejected. The response returns the count of created and updated categories.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Request

Values to create a batch of categories

categorieslist of objectsRequired

array of categories objects

updateEnabledbooleanOptional

Facilitate to update the existing categories in the same request (updateEnabled = true)

Response

Category created and updated

createdCountlong

Number of the new created categories

updatedCountlong

Number of the existing categories updated

Errors

400

Bad Request Error

The API key should be passed in the request headers as api-key for authentication.

Values to create a batch of categories

array of categories objects

Facilitate to update the existing categories in the same request (updateEnabled = true)

Category created and updated

Number of the new created categories

Number of the existing categories updated

1	import { BrevoClient } from "@getbrevo/brevo";
2
3	async function main() {
4	const client = new BrevoClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.ecommerce.createUpdateBatchCategory({
8	categories: [
9	{
10	id: "CAT123",
11	},
12	],
13	});
14	}
15	main();

1	import { BrevoClient } from "@getbrevo/brevo";
2
3	async function main() {
4	const client = new BrevoClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.ecommerce.createUpdateBatchCategory({
8	categories: [
9	{
10	id: "CAT123",
11	},
12	],
13	});
14	}
15	main();