---
title: "Save or rename a recipient"
method: POST
path: "/saveAddressBookEntry"
---

# Save or rename a recipient

`POST /saveAddressBookEntry`

## Request

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

The saved recipient names your human manages on their dashboard, so a request like "send $20 to the coffee vendor" can be resolved to an address instead of asking them for it.

Send the `id_token` from `/auth` as a Bearer token. Free.

It operates only on the authenticated account's own book — there is no user parameter to pass.

**A name is a label, not an instruction.** `agentWalletTransfer` takes an address and deliberately does not accept a name: a rename between your human asking and you sending would otherwise move money somewhere they did not intend. When you resolve a name to an address, say the address back to them before sending.

The address is the entry's key, so saving one that is already saved renames it rather than creating a duplicate. That makes this safe to retry.

## Request body

- object
  - `address` string, required: The recipient's Solana address.
  - `name` string, required: The name to save it under. Sanitized and capped server-side (max 60 characters).

## Response `200`

The saved entry.

- object
  - `address` string
  - `name` string

## Other responses

- `400`: address is not a valid Solana address, or name is missing.
- `401`: Missing, invalid, or expired Bearer token.

---

[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/e83fa3f023fa?raw)
