Create Transfer

wise.create_transfer
ActionBusiness appsconnection required

Calls the Wise API with the connection's credentials.

Create a transfer from an existing quote to an existing recipient. The transfer is only an order until it is funded.

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Wise
Secret shape
the Wise API token, or {"api_token": "…"}
Config it needs
base_url, api_version, profile_id
Resolved by
config.connection_id, else node.connection_id

Configuration

7 fields, 3 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
target_account
The recipient account id to pay.
numberYes—≥ 112345
quote_id
The quote's UUID. One quote creates exactly one transfer.
stringYes———
customer_transaction_id
A UUID you generate. Wise treats it as an idempotency key, so a retry that reuses it returns the first transfer instead of sending twice.
stringYes———
reference
The reference text the recipient sees on their statement.
stringNo———
source_account
Refund recipient account id, used when the transfer has to be returned.
numberNo—≥ 1—
transfer_purpose
Purpose-of-transfer code, required on the routes where Wise's transfer requirements ask for one.
stringNo———
source_of_funds
Source-of-funds code, required on the routes where Wise's transfer requirements ask for one.
stringNo———

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "target_account": 12345
}

Output

One shape.

result

FieldTypeExample
transfer
The full transfer object exactly as Wise returned it.
object—
transfer_id
The transfer id, used to fund, track or cancel it.
string—
status
Where the transfer has reached, for example incoming_payment_waiting or outgoing_payment_sent.
string—
has_active_issues
True when something is already blocking this transfer from being processed.
boolean—
rate
The exchange rate the transfer was created at.
number—
source_currency
Currency the money is sent from.
string—
target_currency
Currency the money is received in.
string—
source_value
Amount debited in the source currency.
number—
target_value
Amount delivered in the target currency.
number—
target_account
The recipient account this transfer pays.
number—
quote_uuid
The quote this transfer was created from.
string—
customer_transaction_id
The idempotency key this transfer was created with.
string—
{
  "customer_transaction_id": "",
  "has_active_issues": false,
  "quote_uuid": "",
  "rate": 0,
  "source_currency": "",
  "source_value": 0,
  "status": "",
  "target_account": 0,
  "target_currency": "",
  "target_value": 0,
  "transfer": {},
  "transfer_id": ""
}

Notes

  • A created transfer moves no money. Fund it with Wise: Fund Transfer, or pay Wise by bank transfer, before it will be processed.

See Create Transfer run in a workflow.

In a technical demo we add the Wise connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.