ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiLightning addresses

Link address to the wallet that receives its payments

PATCH
/api/v1/lightning-address/{id}/wallet

Set providerId to receive on a connected external LNbits provider (BYO wallet), accountWalletId to receive on a specific account wallet, or neither to reset to the default platform-provisioned wallet. Only one of the two may be set. Ownership of both the address and the target wallet/provider is verified.

Authorization

bearer

Path Parameters

id*string

Header Parameters

X-API-Version?string

API version for header-based versioning

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

Request Body

application/json
  1. body
nwcConnectionId?|

NWC connection id (your own wallet) to receive payments on. Null clears it.

accountWalletId?|

Specific account wallet id to receive payments. Null clears it.

Response Body

Wallet link updated.

Example Request
curl -X PATCH 'http://localhost:3001/api/v1/lightning-address/string/wallet' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
Empty