---
updatedAt: 2026-04-20T19:33:47.000Z
---

# Verify an email address

The /oauth/verify\_email\_native operation triggers the Registration system to send an email based on the configuration defined for the form used in the API call.

Email verification can also be initiated when a user registers (via [/oauth/register\_native\_traditional](https://techdocs.akamai.com/identity-cloud-auth/reference/post-oauth-register-native-traditional).

<br />

# 1. Send verification email

[block:code]
{
  "codes": [
    {
      "code": "$api_call= '/oauth/verify_email_native';\n$params= array(\n    'client_id'=> JANRAIN_LOGIN_CLIENT_ID,\n    'flow'=> JANRAIN_FLOW_NAME,\n    'flow_version'=> JANRAIN_FLOW_VERSION,\n    'locale'=> 'en-US',\n    // page where the user is sent\n    'redirect_uri'=> EMAIL_VERIFICATION_URL,\n    // the name of your resend-verification form as defined in the flow file\n    'form'=> 'resendVerificationForm',\n    // required field from resendVerificationForm\n    'signInEmailAddress'=> $_POST['email']\n);\n$curl= curl_init();\ncurl_setopt($curl,CURLOPT_URL,JANRAIN_CAPTURE_URL.$api_call);\ncurl_setopt($curl,CURLOPT_POST,true);\ncurl_setopt($curl,CURLOPT_RETURNTRANSFER,true);\ncurl_setopt($curl,CURLOPT_POSTFIELDS,http_build_query($params));\n$api_response= json_decode(curl_exec($curl));\ncurl_close($curl);",
      "language": "text"
    }
  ]
}
[/block]

| **Response**                                                       | **Outcome / Next Step**                   |
| :----------------------------------------------------------------- | :---------------------------------------- |
| Success (ok)                                                       | Email verification email is sent to user. |
| No account found for provided email address (invalid\_credentials) | Provide a resolution path for this error. |
| Email address already verified (triggered\_error)                  | Provide a resolution path for this error. |

<br />

# 2. Retrieve the verification code

A successful oauth/verify\_email\_native call will send the email to the user which contains the verify\_email\_url appended with a verification code. The landing page for this link must parse the verification code and consume it via the /access/useVerificationCode API call.

<br />

# 3. Consume the verification code

[block:code]
{
  "codes": [
    {
      "code": "curl -X POST\n// verification code parsed from verify_email_url\n--data-urlencode `verification_code=12345678912345678912345678912345` \\\n'https://my-app.janraincapture.com/access/useVerificationCode'",
      "language": "text"
    }
  ]
}
[/block]

| **Response**                                         | **Outcome / Next Step**                                                                         |
| :--------------------------------------------------- | :---------------------------------------------------------------------------------------------- |
| Success (ok)                                         | The Registration server automatically sets the timestamp on the user’s emailVerified attribute. |
| Verification code not recognized (invalid\_argument) | Provide a resolution path for this error.                                                       |

# Sibling pages

* [Complete traditional login and registration](https://techdocs.akamai.com/identity-cloud/docs/traditional-login-and-registration-api-based.md)
* [Complete social login and registration](https://techdocs.akamai.com/identity-cloud/docs/social-login-and-registration-api-based.md)
* [Merge accounts](https://techdocs.akamai.com/identity-cloud/docs/account-merging-api-based.md)
* [Link or unlink accounts](https://techdocs.akamai.com/identity-cloud/docs/account-linking-and-unlinking-api-based.md)
* [Reset a password](https://techdocs.akamai.com/identity-cloud/docs/the-forgot-password-process-api-based.md)
* [Update a user profile](https://techdocs.akamai.com/identity-cloud/docs/user-profile-update-api-based.md)
* [Exchange an authorization code](https://techdocs.akamai.com/identity-cloud/docs/the-exchange-authorization-code-process-api-based.md)