
BoH.32472 (Customer) asked a question.
Hi,
We built our sms enroll page by calling this api /api/v1/authn/factors.
Now user wants to change his enrolled phone number. After admin reset user's sms factor, user cannot enroll with a new phone number with above api. But we found on Okta's enroll page, there is a request parameter /api/v1/authn/factors?updatePhone=true, then user can reenroll with a new phone number.
We don't see this parameter in Okta api document, https://developer.okta.com/docs/reference/api/authn/*enroll-okta-sms-factor.
Is it a formal released feature? Can we use this updatePhone=true in our product to allow user enroll with a new phone number?

Hi @BoH.32472 (Customer),
Thank you for posting on the Okta community page!
I have done some research on my end and it seems that your inquiry can be achieved, based on other customers responses, that I have provided bellow:
Additionally, please keep in mind that you cannot update the phone number when there is currently a phone that has been activated on the user profile. If you will need to re-enroll you will have to start from scratch and delete the phone number from the user profile and only then perform the API call with the updatePhone=true parameter.
I hope the above information is useful!
Hi @flaviu.vrinceanu1.5628408972654734E12 (Customer Success Service Delivery) ,
Thanks for your reply.
I found the same link while searching in devforum.
We will reset user's factor to allow user enroll a new factor. https://developer.okta.com/docs/reference/api/factors/#reset-factor
It would be great if the api document can be updated.
updatePhone parameter is in User Factor Lifecycle apis doc:
https://developer.okta.com/docs/reference/api/factors/#request-parameters-7
But not mentioned in Authentication Enroll Factor api:
https://developer.okta.com/docs/reference/api/authn/#request-parameters-for-enroll-factor
My web application uses the Okta API to allow account holders to activate or deactivate SMS MFA. There is, however, an issue I'm experiencing as described below:
First, on a newly created account:
My SMS factor is auto-activated now that I am unable to receive SMS and I want to enroll again. Here the issue is the auto-activating SMS factor.
How to fix this issue? Any lead will be appreciated & I am using another third-party SMS provider they will api doc to integrate our panel here is the link: https://smsala.com/docs/