ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiNwc connections

Connect a wallet via a Nostr Wallet Connect URI

POST
/api/v1/nwc-connections

Validates the URI with a live get_info round-trip before saving. The connection string is stored AES-encrypted and can be revoked any time from the wallet app.

Authorization

bearer

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Request Body

application/json
  1. body
name*string

Friendly label for the wallet switcher

connectionString*string

Nostr Wallet Connect URI from your wallet (Alby Hub → App Store → Connect app, coinos, Umbrel, LNbits NWC extension, …)

Response Body

Wallet connected

Example Request
curl -X POST 'http://localhost:3001/api/v1/nwc-connections' \  -H 'Content-Type: application/json' \  -d '{  "name": "My Alby Hub",  "connectionString": "nostr+walletconnect://69effe7b...?relay=wss://relay.getalby.com/v1&secret=c60320b3..."}'
Example Response
Empty