Turnkey home page
Search...
⌘K
Ask AI
Demo
Login
Get started
Get started
Search...
Navigation
SDK reference
updateUserPhoneNumber()
Documentation
SDK reference
API reference
Security
Changelogs
Support
Blog
Contact us
SDK reference
Introduction
React
Overview
Getting started
Authentication
Using embedded wallets
Using external wallets
Signing
UI customization
Sub-organization customization
Advanced API requests
Advanced backend authentication
Troubleshooting
Legacy (@turnkey/sdk-react)
SDK reference
addOauthProvider()
addPasskey()
clearAllSessions()
clearSession()
clearUnusedKeyPairs()
completeOauth()
completeOtp()
connectWalletAccount()
createApiKeyPair()
createPasskey()
createWallet()
createWalletAccounts()
deleteSubOrganization()
disconnectWalletAccount()
exportPrivateKey()
exportWallet()
exportWalletAccount()
fetchUser()
fetchWalletAccounts()
fetchWallets()
getActiveSessionKey()
getAllSessions()
getProxyAuthConfig()
getSession()
getWalletProviders()
handleAddEmail()
handleAddOauthProvider()
handleAddPasskey()
handleAddPhoneNumber()
handleAppleOauth()
handleExportPrivateKey()
handleExportWallet()
handleExportWalletAccount()
handleFacebookOauth()
handleGoogleOauth()
handleImportWallet()
handleConnectExternalWallet()
handleLogin()
handleRemoveOauthProvider()
handleRemovePasskey()
handleRemoveUserEmail()
handleRemoveUserPhoneNumber()
handleSignMessage()
handleUpdateUserEmail()
handleUpdateUserName()
handleUpdateUserPhoneNumber()
importPrivateKey()
importWallet()
initOtp()
loginOrSignupWithWallet()
loginWithOauth()
loginWithOtp()
loginWithPasskey()
loginWithWallet()
logout()
refreshSession()
refreshUser()
refreshWallets()
removeOauthProviders()
removePasskeys()
removeUserEmail()
removeUserPhoneNumber()
setActiveSession()
signAndSendTransaction()
signMessage()
signTransaction()
signUpWithOauth()
signUpWithOtp()
signUpWithPasskey()
signUpWithWallet()
storeSession()
switchWalletProviderChain()
updateUserEmail()
updateUserName()
updateUserPhoneNumber()
verifyOtp()
switchWalletAccountChain()
fetchPrivateKeys()
handleDiscordOauth()
handleImportPrivateKey()
handleXOauth()
React Native
Flutter
Swift
TypeScript | Frontend
TypeScript | Server
Golang
Rust
Ruby
CLI
Python
Web3 libraries
Advanced
Migration Path
SDK reference
updateUserPhoneNumber()
Copy page
Copy page
Package:
react-wallet-kit
Overview
Updates the user’s phone number.
This function updates the user’s phone number and, if provided, verifies it using a verification token (from an OTP flow).
If a userId is provided, it updates the phone number for that specific user; otherwise, it uses the current session’s userId.
If a verificationToken is not provided, the phone number will be updated but will not be marked as verified.
Automatically ensures an active session exists before making the request.
Handles session management and error reporting for both update and verification flows.
Parameters
params
object
required
Show params details
params.
phoneNumber
string
required
new phone number to set for the user.
params.
stampWith
StamperType
parameter to stamp the request with a specific stamper (StamperType.Passkey, StamperType.ApiKey, or StamperType.Wallet).
params.
userId
string
user ID to update a specific user’s phone number (defaults to the current session’s userId).
params.
verificationToken
string
verification token from OTP phone verification (required if verifying the phone number).
Response
A successful response returns the following fields:
returns
string
required
A promise that resolves to the userId of the updated user.
Was this page helpful?
Yes
No
updateUserName()
verifyOtp()
Assistant
Responses are generated using AI and may contain mistakes.