/pre-register

✅ Email as user_id

These are the possible response codes when you make an API call to the /pre-register endpoint using an email address as user_id.

Response codeErrorMessageScenarioResolution
201 Created-uuid valueSuccessful response
201 Created-uuid valueSuccessful resending of activation link-
201 Created-uuid valueSuccessful pre-registration with missing locale-
201 Created-uuid valueMissing grant_type value-
201 Created-uuid valueSuccessful pre-registration with empty locale-
201 Created-uuid valueSuccessful pre-register when grant_type is invalid-
201 Created-uuid valueSuccessful pre-register when resend value is invalid-
400 Bad Requesthttp_exception"Invalid json format"Empty payloadAdd the payload.
400 Bad Requestinvalid_parameters"Invalid json format"Invalid JSON format used in the payload.Use correct JSON format for the payload.
422 Unprocessable Entityinvalid_form_fields"emailAddress": s]
{

"error_description": "some inputs are invalid"
Error on pre-registration of existing emailEnter a valid email address that hasn't been registered.
422 Unprocessable Entityinvalid_form_fields"emailAddress": s]
{

"error_description": "some inputs are invalid"
Error on pre-registration of existing email when resend is falseEnter a valid email address that hasn't been registered.
422 Unprocessable Entityinvalid_parameters"auth_type": "field required"Removed auth_type parameterAdd the auth_type parameter and value.
422 Unprocessable Entityinvalid_parameters"redirect_uri": "field required"Removed redirect_uri parameterAdd the redirect_uri parameter and value.
422 Unprocessable Entityinvalid_parameters"grant_type": "field required"Removed grant_type parameterAdd the grant_type parameter and value.
422 Unprocessable Entityinvalid_parameters"profile_fields": "field required"Removed profile_fields parameterAdd the profile_fields parameter and value.
422 Unprocessable Entityinvalid_parameters"emailAddress": {
"missing": "required"
}

no error description
Removed emailAddress parameterAdd the emailAddress parameter and value.
422 Unprocessable Entityinvalid_parameters"client_id": {
"missing": "required"
}

no error description
Missing client_id valueEnter the client_id value
422 Unprocessable Entityinvalid_parameters"auth_type": {
"invalid": "unsupported auth_type value"
}

no error description
Missing auth_type valueEnter a valid auth_type value.
422 Unprocessable Entityinvalid_parameters"error_details": null,
"error_description": "Missing Parameter: redirect_uri"
Missing redirect_uri valueEnter a valid "redirect_uri` value.
422 Unprocessable Entityinvalid_parameters"emailAddress": {
"missing": "required"
}

no error description
Missing profile_fields valueEnter a valid profile_fields value.
422 Unprocessable Entityinvalid_parametersExample:

"380": "Expecting value: line xx column xx (char 380)
Missing resend valueEnter a valid resend value.
422 Unprocessable Entityinvalid_parameters"user_id": {
"missing": "required"
}

no error description
Missing emailAddress valueEnter a valid `emailAddress value.
422 Unprocessable Entityinvalid_parameters"auth_type": {
"invalid": "unsupported auth_type value"
}

no error description
Invalid auth_type valueEnter a valid auth_type
422 Unprocessable Entityinvalid_parameters"redirect_uri": {
"invalid": "invalid value"
}

no error description
Invalid redirect_uri valueEnter a valid redirect_uri value.
422 Unprocessable Entityinvalid_parameters"emailAddress": s]
{

"error_description": "some inputs are invalid"
Invalid emailAddress valueEnter a valid emailAddress value.
422 Unprocessable Entityunexpected_error"error_details": null,
"error_description": "could not find a flow 'standard_global" with version "20220207155201304965' and locale 'xxxx' "
Invalid locale valueEnter a valid locale value.

✅ Mobile phone number as user_id

These are the possible response codes when you make an API call to the /pre-register endpoint using a mobile phone number as user_id.

Response codeErrorMessageScenarioResolution
---Successful pre-registration-
-uuid valueError when resend parameter is true-
-uuid valueError when grant_type is empty-
-uuid valueSuccessful sending when resend is true-
invalid_form_fields"mobilePrimary": [
"Mobile phone is already in use"

"error_description": "some inputs are invalid"
Error when mobile number existEnter a mobile phone number that is not registered yet.
invalid_form_fields"mobilePrimary": [
"Mobile phone is already in use"

"error_description": "some inputs are invalid"
Error when resend parameter is falseEnter a mobile phone number that is not registered yet.
invalid_parameters"auth_type": "field required"Removed auth_type parameterAdd the auth_type parameter and value.
invalid_parameters"redirect_uri": "field required"Removed redirect_uri parameterAdd the redirect_uri parameter and value.
invalid_parameters"grant_type": "field required"Removed grant_type parameterAdd the grant_type parameter and value.
invalid_parameters"profile_fields": "field required"Removed profile_fields parameterAdd the profile_fields parameter and value.
422 Unprocessable Entityinvalid_parameters"mobilePrimary": {
"missing": "required"
}

no error description
Removed mobilePrimary parameterAdd the mobilePrimary parameter and value.
422 Unprocessable Entityinvalid_parameters"auth_type": {
"invalid": "unsupported auth_type value"
}

no error description
Missing auth_type valueEnter a valid auth_type value.
422 Unprocessable Entityinvalid_parameters"error_details": null,
"error_description": "Missing Parameter: redirect_uri"
Missing redirect_uri valueEnter a valid redirect_uri value.
422 Unprocessable Entityinvalid_parameters"mobilePrimary": {
"missing": "required"
}

no error description
Missing mobilePrimary valueEnter a valid `mobilePrimary value.
422 Unprocessable Entityinvalid_parameters"auth_type": {
"invalid": "unsupported auth_type value"
}

no error description
Invalid auth_type valueEnter a valid auth_type value.
422 Unprocessable Entityinvalid_parameters"redirect_uri": {
"invalid": "invalid value"
}

no error description
Invalid redirect_uri valueEnter a valid redirect_uri value.
422 Unprocessable Entityunexpected_errorExample:

"error_details": null,
"error_description": "could not find a flow named 'standard_global' with version '20220207155201304965' and locale 'xxxx' "
Invalid locale valueEnter a valid locale value.
422 Unprocessable Entityinvalid_form_fields"mobilePrimary": ]
{

"error_description": "some inputs are invalid"
Existing mobilePrimary value and resend value is falseEnter a mobilePrimary value that is not registered yet.
422 Unprocessable Entityinvalid_form_fields"mobilePrimary": ]
{

"error_description": "some inputs are invalid"
Existing mobilePrimary valueEnter a mobilePrimary value that is not registered yet.
502 Bad Gateway--Invalid mobilePrimary valueEnter a valid mobilePrimary value.