---
title: "Add a Transfer"
method: POST
path: "/transfers"
tags: ["Transfers"]
---

# Add a Transfer

`POST /transfers`

Use this endpoint when you want to create a Transfer between any 2 of your float/bank accounts.
<aside class="notice">We now require supplying an <code>Idempotency-Key</code> header when performing this request to ensure you can safely retry the action in case of an issue. If the header value is different to one provided previously, we will be treating a request as a new operation which may lead to duplicate payments. To understand more on how to make idempotent requests, please refer to our <a href="https://docs.zeptopayments.com/v20260101/reference/idempotent-requests">Idempotent requests guide</a>.</aside>

## Headers

- `Idempotency-Key` string, required

## Request body

- AddATransferRequest
  - `from_bank_account_id` string, required — The source float/bank account (UUID)
  - `to_bank_account_id` string, required — The destination float/bank account (UUID)
  - `amount` integer, required — Amount in cents (Min: 1 - Max: 99999999999)
  - `description` string, required — Description for the Transfer. ASCII-printable characters and unicode emojis are accepted.
  - `matures_at` string, date-time, required — Date & time in UTC ISO8601 the Transfer should be processed. (Can not be earlier than the start of current day in Sydney AEST/AEDT)

## Response `201`

Created

- AddATransferResponse
  - `data` object, required
    - `ref` string, required — The Transfer request reference (T.*) (Min: 4 - Max: 8)
    - `from_bank_account_id` string, required — The source bank/float account (UUID)
    - `to_bank_account_id` string, required — The destination bank/float account (UUID
    - `amount` integer, required — The amount value provided (Min: 1 - Max: 99999999999)
    - `description` string, required — Description for the Transfer
    - `matures_at` string, date-time, required — Date & time in UTC ISO8601 the Transfer should be processed. (Can not be earlier than the start of current day in Sydney AEST/AEDT)

---

[API](https://skmtc.net/zeptopayments/apis/zepto-api.md) · [All operations](https://skmtc.net/zeptopayments/apis/zepto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeptopayments/zepto-api/revisions/6353e9b9af6f/schema)