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

# Create a new batch

`POST /v1/batches`

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.

## Response `200`

Batch created successfully

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

## Other responses

- `400` — An error has occured. 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 occured. 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 occured. 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.

---

[API](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api.md) · [All operations](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefinancialservices/fire-financial-services-business-api/revisions/1d19896d095c/schema)