---
title: "Create an access token for the Recipients embedded experience"
method: POST
path: "/v2.01/oauth/token/embedded/recipient"
tags: ["Authentication"]
---

# Create an access token for the Recipients embedded experience

`POST /v2.01/oauth/token/embedded/recipient`

Generate an access token to run the [Recipients frontend embedded experience](/sdks/elements) using Mangopay Elements

A single access token can be used to service the experience to one user and has a lifespan of 15 minutes. You need to provide the `UserId` of the Natural User or Legal User who will use the frontend session to register a Recipient.

## Headers

- `Authorization` string, required

## Request body

- CreateAnAccessTokenForTheRecipientsEmbeddedExperienceRequest
  - `clientId` string, required — Your Mangopay Client ID.
  - `claims` CreateAnAccessTokenForTheRecipientsEmbeddedExperienceRequestClaims, required — Claims for the access token request.
    - `userId` string, required — Unique identifier of the Natural User or Legal User using the Recipient frontend experience to register a bank account.

## Response `200`

Success

- RecipientAccessTokenResponse
  - `access_token` string — The value to use as the `clientToken` when initializing Mangopay Elements for the [Recipients embedded experience](/sdks/elements).
  - `token_type` string — **Returned values:** `Bearer` The type of the token.
  - `expires_in` integer — The number of seconds until the token expires.
  - `scope` string — **Returned values:** `bankaccounts:r bankaccounts:w` The API permission scopes of the token, in this case to read and write bank account data.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)