---
title: "Initiate a transfer"
method: POST
path: "/transfers"
tags: ["transfers"]
---

# Initiate a transfer

`POST /transfers`

Initiate a transfer between funding sources from a Dwolla Account or API Customer resource. Supports ACH, Instant Payments (RTP/FedNow), Push-to-Debit Card, and wire transfers with optional expedited clearing, facilitator fees, metadata, and correlation IDs for enhanced traceability. Includes idempotency key support to prevent duplicate transfers and extensive customization options for addenda records and processing channels. Returns the location of the created transfer resource for tracking and management.

## Headers

- `Accept` 'application/vnd.dwolla.v1.hal+json', required
- `Idempotency-Key` string

## Request body

- object
  - `_links` object, required
    - `source` object
      - `href` string
    - `destination` object
      - `href` string
  - `amount` TransferAmount, required
    - `value` string, required
    - `currency` string, required
  - `metadata` object
  - `fees` object[]
    - `_links` object
      - `charge-to` object
        - `href` string
    - `amount` TransferAmount
      - `value` string, required
      - `currency` string, required
  - `clearing` object
    - `source` string
    - `destination` string
  - `achDetails` object
    - `source` object
      - `addenda` object
        - `values` string[]
    - `destination` object
      - `addenda` object
        - `values` string[]
  - `rtpDetails` object — Real-Time Payments (RTP) specific transaction details.
    - `destination` object — RTP details for the destination
      - `remittanceData` string — Remittance information for Real-Time Payments, providing context about the payment purpose. Acceptable characters: alphanumeric (0-9, a-z, A-Z), space, and special characters (#,.'&/-@!$%*()_+={}|:;`[]^~\")
  - `instantDetails` object — Instant Payments specific transaction details for both RTP and FedNow networks.
    - `destination` object — Instant payment details for the destination
      - `remittanceData` string — Remittance information for Instant Payments (RTP/FedNow), providing context about the payment purpose. Acceptable characters: alphanumeric (0-9, a-z, A-Z), space, and special characters (#,.'&/-@!$%*()_+={}|:;`[]^~\")
  - `correlationId` string
  - `processingChannel` object
    - `destination` 'real-time-payments' | 'instant'

## Response `201`

created

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/dwolla/apis/dwolla-api.md) · [All operations](https://skmtc.net/dwolla/apis/dwolla-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dwolla/dwolla-api/versions/0e13062ae3be/schema)