Skip to main content

Add a OTP SMS authenticator​

Add a new one-time-password (OTP) SMS authenticator to a user. If the phone is not passed as verified, a verification code will be generated, which can be either returned or will be sent to the user by SMS.

Path Parameters
    userId string required

    unique identifier of the user.

Request Body required
    phone object

    Set the user's phone for the OTP SMS authenticator and it's verification state.

    number string required

    Possible values: non-empty and <= 20 characters

    Set the user's phone number.

    sendCode object

    Let ZITADEL send the link to the user via SMS.

    returnCode object

    Get the code back to provide it to the user in your preferred mechanism.

    isVerified boolean

    Set the phone as already verified.

Responses

OTP SMS authenticator successfully added

Schema
    details object
    sequence uint64

    on read: the sequence of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    changeDate date-time

    on read: the timestamp of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    resourceOwner resource_owner is the organization or instance_id an object belongs to
    otpSmsId string

    unique identifier of the OTP SMS registration.

    verificationCode string

    The OTP verification code will be set if a phone was set with a return_code verification option.

Loading...