Wallets

Get Started

Create user or server wallets, authenticate with your backend, connect to external wallets, and more. User wallets can be created using different authentication methods:

  • verification code (email, phone, etc.)
  • oauth (google, apple, etc.)
  • passkey
  • sign in with ethereum

API Usage

You can use the thirdweb API to create user wallets.

Authentication requires either x-secret-key (backend) or x-client-id (frontend) to be set in the request headers.

Send a login code to the user

POST /v1/wallets/user/code
Host: api.thirdweb.com
Content-Type: application/json
x-client-id: <your-project-client-id>
{
"type": "email",
"email": "[email protected]"
}

Verify the code and authenticate the user

POST /v1/wallets/user/code/verify
Host: api.thirdweb.com
Content-Type: application/json
x-client-id: <your-project-client-id>
{
"type": "email",
"email": "[email protected]",
"code": "123456",
}

Once authenticated, the endpoint will return the wallet address and a JWT token for usage with the rest of the API.

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: