---
title: "Attach bank details to a recipient"
method: POST
path: "/addBankingDestination"
tags: ["Banking"]
---

# Attach bank details to a recipient

`POST /addBankingDestination`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/addBankingDestination`
- Auth: API key in header `Authorization`

Attaches a bank account or crypto address to a recipient and returns the `destination_id` that `/send-bank-payment` pays out to.

A Firebase callable. Callables wrap the request in `{"data": ...}` and the reply in `{"result": ...}`. Send the `id_token` from `/auth` as a Bearer token. Free.

## Request body

- object
  - `data` object, required
    - `userId` string, required: The Laso user id (the `usr_...` value from /auth).
    - `recipientId` string, required: The recipient from `createBankingRecipient`.
    - `destination` object, required: The destination. For a US bank account: `destination_type: "fiat_us"` plus `aba_routing_number`, `account_number`, `account_type`, `account_holder_name`, and `bank_name`. Also supports `fiat_iban` and `crypto`.
    - `nickname` string: An optional label. The only field editable later, via `updateBankingDestination`.
    - `recipientAddress` object: Sets the recipient's postal address before attaching the destination. Needed when the recipient was created name-only: bank destinations are rejected without one, so supplying it here avoids a dead end.

## Response `200`

The destination, including its `destination_id`.

- object
  - `result` object

## Other responses

- `400`: A required field is missing or invalid.
- `401`: Missing, invalid, or expired Bearer token.
- `403`: The caller is not this user and is not an admin.

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)