Link Requests

Embedded Flows are Wise-hosted flows that partners can open for their users or embed inside their own product with an iframe or mobile WebView.

Use the embedded link request endpoints to create a short-lived flow URL for a profile or retrieve an embedded link request by ID. For an overview of when to use Embedded Flows, see the Embedded Flows guide.

Operations

Recipient creation

Request

Returns a link that allows a user to complete a recipient creation flow via either a redirect or embedded iframe/webview.

View Embedded Flows - Recipient Creation to see what data the frontend is returned upon flow completion.

Security

UserToken

Path

profileIdinteger, (int64)required

The profile ID.

X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479

Bodyapplication/jsonrequired

redirectUrlstring, (uri)required

URL where the user will be redirected when the flow resolves. This will also include query parameters based on flow completion state and created recipient ID.

View Embedded Flows - Recipient Creation for more information.

Example:"https://example.com/return"

targetCurrencystring

Optional target currency used to start recipient requirements for a specific currency.

Example:"USD"

curl -i -X POST \
  'https://api.wise.com/2026Q3/profiles/{profileId}/embedded-flows/link-requests/recipients' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -d '{
    "redirectUrl": "https://example.com/return",
    "targetCurrency": "USD"
  }'

Responses

Embedded link request created.

Headers

X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"

x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"

Bodyapplication/json

urlstring, (uri)required

Unique URL to open or embed for the user.

Example:"https://wise-sandbox.com/embedded-flows?embeddedLinkRequestId=9f5f5812-2609-4e48-8418-b64437c0c7cd#token=0d0bdc88-bcf4-43dd-85be-7ca65441db20"

expiresAtstring, (date-time)required

Timestamp when the returned flow URL expires.

Example:"2026-06-15T13:23:20.265Z"

Response