Resend Verification

Resend a user verification with the Next Identity API

📘

API reference for /resend-verification endpoint

In addition to the integration documentation in this section, refer to the API Reference for the /profile endpoint for more details.

Introduction

The resend verification functionality has two main methods: The API-only integration and the hybrid approach.

The API-only integration allows the user to receive a PIN to verify their email or mobile number and log in.

The hybrid approach supports PIN, or the user can receive a link which will redirect them to the Next Identity Journeys to complete the verification process.

Assumption

  • Application is hosting the registration screen or has a hybrid of both API and Next Identity Journey screens.
  • Application is responsible for securely sending these API calls to the Next Identity.
  • Application will need to handle range of responses from the service.
  • API calls will be rate limited for each client ID; please consult with your integration consultant to change these limits if needed.

Supported Use Cases

The following /resend-verification use cases are supported:

  • Resend verification to user by email address
  • Resend verification to user by mobile phone number

These use cases are discussed in the following section.

Resend verification to user by email address

Introduction

For applications using Next Identity Journeys, the recommended method to resend an activation or invite email is for the end user to visit the hosted screens and initiate the process themselves.
In rare instances, there is a need to resend a verification email with an API integration. Below are some existing samples of how this call is made by calling the /resend-verification API endpoint for triggering this email verification.

Sample API Call

This is a sample API call to resend a verification email to an end user.

curl --location --request POST 'https://id.eu.nextreason.com/idp/v1/account/resend-verification' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "c8462jyq9dnupu2q4j7sfjzvn6c87j92",
    "auth_type": "email",
    "redirect_uri": "https://localhost.com",
    "user_id": "[email protected]",
    "locale": "en-US"
}'

Resend verification to user by mobile phone number

Introduction

For applications using Next Identity Journeys, the recommended method to resend an activation or invite is for the end user to visit the Next Identity Journeys resend verification screen and initiate the self-service process.

In rare instances, there is a need to resend a verification email with an API integration. Below are some existing samples of how this call is made by calling the /resend-verification API endpoint for triggering this verification via SMS.

Sample API Call

This is a sample API call to resend a verification code via SMS to an end user.

curl --location --request POST 'https://id.eu.nextreason.com/idp/v1/account/resend-verification' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '
{
     "auth_type": "sms",
     "user_id": "+15417543010",
     "redirect_uri": "https://localhost.com",
     "client_id": "c8462jyq9dnupu2q4j7sfjzvn6c87j92",
     "locale": "en-US"
}'

What’s Next