---
title: "Create Transfer"
method: POST
path: "/accounts/{account_id}/transfers"
tags: ["Orders"]
---

# Create Transfer

`POST /accounts/{account_id}/transfers`

Create Transfer

## Path parameters

- `account_id` string, required — ID of the resource

## Request body

- CreateTransfer
  - `amount` Amount, required
    - `currency` string, required
    - `value` string, required
  - `brand` BrandData, nullable
    - `account_id` string, required
  - `destination` PaymentData, required
    - `ach_description` string, nullable — Description for an ACH payment, which the counterparty's bank may show on the statement. Set it on the ACH leg: `source` when funding from a bank (debit), `destination` when paying out to one (credit). Characters the ACH network does not carry are removed and the value is trimmed, then the leading 10 characters of the result are sent as the Nacha company entry description. A value that is empty once sanitized is not rejected; it falls back to PAYOUT for a credit or PAYMENT for a debit. Applicable to ACH transfers only.
    - `address_id` string
    - `financial_institution_id` string
    - `transfer_type` string, required
    - `value_type` string, required
    - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
  - `note` string
  - `source` PaymentData, required
    - `ach_description` string, nullable — Description for an ACH payment, which the counterparty's bank may show on the statement. Set it on the ACH leg: `source` when funding from a bank (debit), `destination` when paying out to one (credit). Characters the ACH network does not carry are removed and the value is trimmed, then the leading 10 characters of the result are sent as the Nacha company entry description. A value that is empty once sanitized is not rejected; it falls back to PAYOUT for a credit or PAYMENT for a debit. Applicable to ACH transfers only.
    - `address_id` string
    - `financial_institution_id` string
    - `transfer_type` string, required
    - `value_type` string, required
    - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.

## Response `201`

OK

- union
  - object
    - `amount` Amount
      - `currency` string, required
      - `value` string, required
    - `created_at` string, date-time — ISO-8601 timestamp that includes date and time
    - `destination` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `failure` Failure
      - `errors` ApiError[], required
        - `code` string
        - `detail` string, nullable
        - `id` string, nullable
        - `links` object, nullable
        - `meta` object, nullable
        - `source` object, nullable
          - `parameter` string
          - `pointer` string
        - `status` string
        - `title` string
      - `links` object, nullable
      - `meta` object, nullable
    - `funding_simulated` boolean — When true, inbound ACH funding was simulated for testnet or sandbox rather than submitted to Dwolla
    - `id` string — ID of the resource
    - `note` string
    - `source` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `status` 'pending' | 'processing' | 'complete' | 'canceled' | 'failed' | 'compliance review'
    - `updated_at` string, date-time — ISO-8601 timestamp that includes date and time
  - object
    - `amount` Amount
      - `currency` string, required
      - `value` string, required
    - `created_at` string, date-time — ISO-8601 timestamp that includes date and time
    - `destination` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `failure` Failure
      - `errors` ApiError[], required
        - `code` string
        - `detail` string, nullable
        - `id` string, nullable
        - `links` object, nullable
        - `meta` object, nullable
        - `source` object, nullable
          - `parameter` string
          - `pointer` string
        - `status` string
        - `title` string
      - `links` object, nullable
      - `meta` object, nullable
    - `funding_simulated` boolean — When true, inbound ACH funding was simulated for testnet or sandbox rather than submitted to Dwolla
    - `id` string — ID of the resource
    - `note` string
    - `source` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `status` 'pending' | 'processing' | 'complete' | 'canceled' | 'failed' | 'compliance review'
    - `updated_at` string, date-time — ISO-8601 timestamp that includes date and time
    - `automation_id` string, required
  - object
    - `amount` Amount
      - `currency` string, required
      - `value` string, required
    - `created_at` string, date-time — ISO-8601 timestamp that includes date and time
    - `destination` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `failure` Failure
      - `errors` ApiError[], required
        - `code` string
        - `detail` string, nullable
        - `id` string, nullable
        - `links` object, nullable
        - `meta` object, nullable
        - `source` object, nullable
          - `parameter` string
          - `pointer` string
        - `status` string
        - `title` string
      - `links` object, nullable
      - `meta` object, nullable
    - `funding_simulated` boolean — When true, inbound ACH funding was simulated for testnet or sandbox rather than submitted to Dwolla
    - `id` string — ID of the resource
    - `note` string
    - `source` union
      - object
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `financial_institution_id` string, required
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string
        - `payment_details` PaymentDetails
          - `fallback_at` string, date-time, nullable
          - `fallback_reason` string, nullable
          - `fallback_reason_code` string, nullable
          - `imad` string, nullable
          - `original_transfer_type` string, nullable
          - `payment_reference` string, nullable
          - `received_at` string, date-time, nullable
          - `sender_bank_name` string, nullable
          - `sender_bank_routing_number` string, nullable
          - `sender_name` string, nullable
          - `sent_at` string, date-time, nullable
          - `trace_number` string, nullable
        - `requested_transfer_type` string, nullable
        - `transfer_type` string, required
        - `value_type` string, required
        - `wire_memo` string, nullable — OBI memo sent to the receiving bank. Applicable to wire transfers only.
      - object
        - `address_id` string, required
        - `transfer_type` string, required
        - `value_type` string, required
      - object
        - `address_id` string, required
        - `transaction_id` string
        - `transfer_type` string, required
        - `value_type` string, required
    - `status` 'pending' | 'processing' | 'complete' | 'canceled' | 'failed' | 'compliance review'
    - `updated_at` string, date-time — ISO-8601 timestamp that includes date and time
    - `wire_instructions` WireInstructions, required
      - `account_number` string, required
      - `bank_address` string, required
      - `bank_name` string, required
      - `beneficiary_address` string, required
      - `beneficiary_name` string, required
      - `memo` string
      - `routing_number` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

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