Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
link-requests

Recipient creation

Creates a short-lived URL to a Wise-hosted recipient creation Embedded Flow for the given profile.

Use the returned url to redirect the user to Wise or embed the flow in your product with an iframe or mobile WebView. When the flow resolves, Wise redirects the user to the redirectUrl provided in this request.

Wise validates redirectUrl against the redirect URL allowlist configured for your integration.

For an example flow, see the Embedded Flows guide.

post/2026Q2/profiles/{profileId}/embedded-flows/link-requests/recipients

Path parameters

profileIdinteger required

The profile ID.

Headers

X-External-Correlation-Idstring uuid

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

Request body

redirectUrlstring uri required

URL where the user will be redirected when the flow resolves. This URL must match the redirect URL allowlist configured for your integration.

targetCurrencystring

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

Example request

{
  "redirectUrl": "https://example.com/return",
  "targetCurrency": "USD"
}

Response

Embedded link request created.

urlstring uri required

Unique URL to open or embed for the user.

expiresAtstring date-time required

Timestamp when the returned flow URL expires.

Example response

{
  "url": "https://wise-sandbox.com/embedded-flows?embeddedLinkRequestId=9f5f5812-2609-4e48-8418-b64437c0c7cd#token=0d0bdc88-bcf4-43dd-85be-7ca65441db20",
  "expiresAt": "2026-06-15T13:23:20.265Z"
}