Skip to main content

Set contact email

PUT 
/v3alpha/users/:userId/email

Add or update the contact email address of a user. If the email is not passed as verified, a verification code will be generated, which can be either returned or will be sent to the user by email.

Request​

Path Parameters

    userId stringrequired

    unique identifier of the user.

Body

required

    email

    object

    Set the user's contact email and it's verification state.

    address stringrequired

    Possible values: non-empty and <= 200 characters

    Set the email address.

    sendCode

    object

    Let ZITADEL send the link to the user via email.

    urlTemplate string

    Possible values: non-empty and <= 200 characters

    Optionally set a url_template, which will be used in the verification mail sent by ZITADEL to guide the user to your verification page. If no template is set, the default ZITADEL url will be used.

    returnCode object

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

    isVerified boolean

    Set the email as already verified.

Responses​

Email successfully set

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 (string)
    verificationCode string

    The verification code will be set if a contact email was set with a return_code verification option.

Loading...