---
title: "Create batch"
method: POST
path: "/batches"
tags: ["Batch"]
---

# Create batch

`POST /batches`

Batch operations allow for multiple actions of a similar type to be executed in a single request. Utilizing the batch endpoint is recommended to avoid hitting rate limits and to enhance overall performance.

Creating batches is an asynchronous process that initiates the creation or updating of the specified items.

* POST batch operations to create multiple items simultaneously.
* PUT batch operations to apply multiple updates to multiple items.
Each batch operation can include up to 100 actions.

The required scopes depend on the type of batch operation being performed.


**WARNING**: Before sending a batch of **events**, ensure there are no automations configured in Omnisend that could send messages to customers based on the imported data. This could result in duplicate messages being sent to customers.

**Scopes:**

`products.write`, `contacts.write`, `events.write`

<br><a href="https://www.postman.com/omnisend-api/workspace/omnisend/overview" target="_blank">Open Postman collection</a>

## Headers

- `Omnisend-Version` string, required

## Request body

- CreateBatchRequest
  - `endpoint` 'products' | 'contacts' | 'events' | 'categories', required
  - `items` unknown[], required
    - unknown
  - `method` 'POST' | 'PUT', required
  - `origin` string

## Response `201`

Batch created successfully with the given ID

- CreateBatchResponse
  - `batchID` string
  - `totalCount` integer

## Other responses

- `400` — Validation failed
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.dev/omnisend/apis/events-api.md) · [All operations](https://skmtc.dev/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisend/events-api/revisions/50214fbc283f/schema)