---
title: "Recipient creation"
method: POST
path: "/2026Q2/profiles/{profileId}/embedded-flows/link-requests/recipients"
tags: ["link-requests"]
---

# Recipient creation

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

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](/guides/product/embedded-flows/index.md#hosted-recipient-creation-flow).

## Path parameters

- `profileId` integer, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- object
  - `redirectUrl` string, 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.
  - `targetCurrency` string — Optional target currency used to start recipient requirements for a specific currency.

## Response `201`

Embedded link request created.

- object
  - `url` string, uri, required — Unique URL to open or embed for the user.
  - `expiresAt` string, date-time, required — Timestamp when the returned flow URL expires.

## Other responses

- `400` — Invalid request, such as an invalid redirect URL.
- `401` — User is not authorised to access the resource.
- `404` — Profile not found.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)