Skip to main content
POST
Create a transfer

Authorizations

Authorization
string
header
required

API key (pk_test_* or pk_live_), JWT session, agent token (agent_), Ed25519 session (sess_), or portal token (portal_).

Headers

idempotency-key
string

Prevents duplicate transfers on retry; cached for 24h

Body

application/json
fromAccountId
string<uuid>
required
toAccountId
string<uuid>
required
amount
number
required
destinationCurrency
string
quoteId
string<uuid>

Required for cross-currency transfers; lock FX rate via POST /v1/quotes first

description
string
Maximum string length: 500

Response

Transfer created (may still be pending settlement)

data
object
required