---
title: "Create a new batch"
method: POST
path: "/v1/batches"
tags: ["Batch Payments"]
---

# Create a new batch

`POST /v1/batches`

## Request

- Base URL: `https://api.fire.com/business`
- URL: `https://api.fire.com/business/v1/batches`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/firefinancialservices/apis/fire-financial-services-business-api/docs/v1/batches/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint will create a new batch. This opens a new batch container to hold specific transaction types in a certain currency. You will need to enable PERM_BUSINESS_POST_BATCHES to use this endpoint.

## Request body

- NewBatch
  - `type` 'BANK_TRANSFER' | 'INTERNAL_TRANSFER' | 'INTERNATIONAL_TRANSFER': The type of the batch - can be one of the listed 3
  - `currency` string: 3 digit ISO code for the currency you wish to send - GBP, EUR, USD, CAD, etc...
  - `batchName` string: An optional name you give to the batch at creation time.
  - `jobNumber` string: An optional job number you can give to the batch to help link it to your own system.
  - `callbackUrl` string: An optional POST URL that all events for this batch will be sent to.
  - `isInstant` boolean: An optional field that allows you to choose if you want the batch items containined in the batch to be sent as SEPA INST payments. This is only available for EUR bank transfer batches.

## Response `200`

Batch created successfully

- NewBatchResponse
  - `batchUuid` string: A UUID for this item.

## Other responses

- `400`: An error has occurred. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `401`: An error has occurred. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `403`: An error has occurred. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.

## Changes

- **2026-10-23** (v1) `58a9a24b960e`: 1 info
  - added the new optional request property `isInstant`

[Operation history](https://skmtc.dev/firefinancialservices/apis/fire-financial-services-business-api/changes/v1/batches/post.md)

---

[API](https://skmtc.dev/firefinancialservices/apis/fire-financial-services-business-api.md) - [All operations](https://skmtc.dev/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firefinancialservices/apis/fire-financial-services-business-api/revisions/9326fd0a20ea?raw)