---
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
    - `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
    - `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'
    - `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'
    - `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'
    - `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/versions/7446d49997c2/schema)