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.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
target_account The recipient account id to pay. | number | Yes | — | ≥ 1 | 12345 |
quote_id The quote's UUID. One quote creates exactly one transfer. | string | Yes | — | — | — |
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. | string | Yes | — | — | — |
reference The reference text the recipient sees on their statement. | string | No | — | — | — |
source_account Refund recipient account id, used when the transfer has to be returned. | number | No | — | ≥ 1 | — |
transfer_purpose Purpose-of-transfer code, required on the routes where Wise's transfer requirements ask for one. | string | No | — | — | — |
source_of_funds Source-of-funds code, required on the routes where Wise's transfer requirements ask for one. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"target_account": 12345
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
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.