thirdwebDocs
Wallets

Get Started

Create wallets for your users with flexible authentication options. Choose from email/phone verification, social OAuth, passkeys, or external wallet connections.

API Authentication

Authenticating a user is done in two steps:

  • Initiate authentication
  • Complete authentication

Initiate Authentication

Start authentication with email, phone, passkey, or social providers

Request

POST
/v1/auth/initiate
Loading...

Response

{
"method": "sms",
"success": true
}

Complete Authentication

Verify and complete the authentication process:

Request

POST
/v1/auth/complete
Loading...

Response

{
"isNewUser": true,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"type": "email",
"walletAddress": "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"
}

Get Wallet Information

Retrieve authenticated user's wallet details:

Request

GET
/v1/wallets/me
fetch("https://api.thirdweb.com/v1/wallets/me", {
method: "GET",
headers: {
"x-secret-key": "<your-project-secret-key>",
},
});

Response

{
"result": {
"address": "string",
"profiles": [
{
"email": "string",
"emailVerified": true,
"hd": "string",
"id": "string",
"locale": "string",
"picture": "string",
"type": "google",
"familyName": "string",
"givenName": "string",
"name": "string"
}
],
"createdAt": "string",
"smartWalletAddress": "string"
}
}

Going further

To connect with other auth strategies, use external wallets, or sponsor gas for users, check out the following guides:

Explore Full API References

For comprehensive guides on implementing the full thirdweb SDK, explore our language-specific documentation:

TypeScript

TypeScript

React

React

React

React Native

.NET

DotNet

Unity

Unity

Unreal Engine

Unreal Engine