How to Update Existing Enrolled SMS Phone Number for a Single User
Nov 5, 2025
Multi-Factor Authentication
Okta Identity Engine
Overview
This article explains how to update an existing enrolled SMS phone number for a single user.
Applies To
- Multi-Factor Authentication (MFA)
- SMS
- API
- Okta Identity Engine (OIE)
Solution
To update an existing phone number, use SMS factor API Calls. Please follow the steps below:
- Get the Factors list from the user using GET FACTOR API call > Extract the SMS FactorID.
- Delete the Existing SMS FACTOR by using DELETE FACTOR > FactorId has to be mentioned in the URL.
- Then use the POST:
{{url}}/api/v1/users/{{userId}}/factors?updatePhone=trueto update the SMS factor with new phone number.
Request body:
{"factorType": "sms","provider": "OKTA","profile": {"phoneNumber": "+XXXXXX"}}
