---
title: "Register Wallet"
method: POST
path: "/v1/accounts/{account_id}/wallets"
---

# Register Wallet

`POST /v1/accounts/{account_id}/wallets`

## Request

- Base URL: `https://api.textforagents.com`
- URL: `https://api.textforagents.com/v1/accounts/{account_id}/wallets`
- Auth: none declared

Register a PUBLIC address for the account (method
external | agent_generated). Secret key material in ANY
field is refused by the guard — an agent-generated wallet's
seed never transits this API. Registering a wallet also
completes a pending mint-on-payment session, if one exists,
and resumes its parked payment.

## Path parameters

- `account_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- WalletRegisterBody
  - `address` string, required
  - `make_primary` boolean
  - `method` string

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/textforagents/apis/textforagents-api.md) · [All operations](https://skmtc.dev/textforagents/apis/textforagents-api/llms.txt) · [OpenAPI document](https://skmtc.dev/textforagents/apis/textforagents-api/revisions/9306ab0e457b?raw)