Step 1: Initiate Email Enrollment

POST {{HOST}}/admin/v1/MyAuthenticationFactorEnroller

This step requests to enroll in the Email factor.

Prerequisites for this step: - Use the 'Obtain ME access_token' to obtain a valid access token. - Use 'Get my information' to obtain the user 'id' value.

In the request, you must include the value of the user id returned in 'Get my information'.

In the response, deviceId and requestId should be passed in the next step.

Note that the payload does not have the email id. The primary email is fetched from the user's profile.

Request Body

{"schemas"=>["urn:ietf:params:scim:schemas:oracle:idcs:AuthenticationFactorEnroller"], "user"=>{"value"=>"99b7a4b948c74adf947d4fccd3b99972"}, "authnFactors"=>["EMAIL"]}

HEADERS

RESPONSES

status: Created

{"schemas":["urn:ietf:params:scim:schemas:oracle:idcs:AuthenticationFactorEnroller"],"user":{"value":"99b7a4b948c74adf947d4fccd3b99972","$ref":"https://example.identiycloud.com/admin/v1/Users/99b7a4b948c74adf947d4fccd3b99972"},"authnFactors":["EMAIL"],"meta":{"resourceType":"MyAuthenticationFactorEnroller","location":"https://example.identiycloud.com/admin/v1/MyAuthenticationFactorEnroller"},"deviceId":"bcb65790a29143ca960fa67fb530da63","requestId":"f8ee0085-1091-4eb3-b1d4-657ea6e1f3b7o-o1541112590"}