> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetapp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Recipient

> Stage a payout beneficiary and get a recipientId to reference in create-order — so bank details aren't re-sent on every order.

Registers a payout beneficiary (bank / mobile-money account) and returns a
`recipientId`. Pass that id to [Create Order](/api-reference/endpoint-create-order)
instead of re-sending the account details each time.

<Note>
  A `recipientId` is scoped to your account and valid for 24 hours.
</Note>

### Header Parameters

<ParamField header="API-Key" type="string" required>
  Unique API key issued manually through Telegram.
</ParamField>

### Request Body

<ParamField body="currency" type="string" required>
  Destination fiat ISO code (`NGN`, `KES`, `UGX`, `TZS`, `MWK`).
</ParamField>

<ParamField body="institution" type="string" required>
  Payout institution code from [List Institutions](/api-reference/endpoint-list-institutions).
</ParamField>

<ParamField body="accountIdentifier" type="string" required>
  Account number / wallet handle.
</ParamField>

<ParamField body="accountName" type="string" required>
  Exact account name of record.
</ParamField>

<ParamField body="memo" type="string">
  Optional payment memo.
</ParamField>

<ParamField body="providerId" type="string">
  Optional preferred LP provider id.
</ParamField>

### Response

<ResponseField name="status" type="string">Response state (`success`).</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="recipientId" type="string">Reference to pass to create-order.</ResponseField>
  <ResponseField name="expiresInSeconds" type="integer">Lifetime of the id (86400 = 24h).</ResponseField>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "currency": "NGN",
    "institution": "GTBINGLA",
    "accountIdentifier": "0123456789",
    "accountName": "Jane Doe",
    "memo": "Invoice 42"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response (201 Created) theme={null}
  {
    "status": "success",
    "message": "Recipient created",
    "data": {
      "recipientId": "75aa152e-c63f-4d9d-a5c1-4c9d4be7fc3c",
      "expiresInSeconds": 86400
    }
  }
  ```
</ResponseExample>