Wallets

Create Server Wallet

Creates a server wallet from a unique identifier. If the wallet already exists, it will return the existing wallet.

Authentication: This endpoint requires backend authentication using the x-secret-key header. The secret key should never be exposed publicly.

post/v1/wallets/server

Request

Base URL
https://api.thirdweb.com
Auth
API key in header x-secret-key

Request body

identifierstring required

Unique identifier for wallet creation or retrieval. Can be user ID, email, or any unique string. The same identifier will always return the same wallet.

Example request

{
  "identifier": "treasury-wallet-123"
}

Response

Server wallet created or connected successfully. Returns wallet addresses for subsequent operations.

Changes

No recorded changes to this operation across all 5 revisions of this API.