Home → API Documentation → Login / Password Reset → Overview of Validation Process

4.5. Overview of Validation Process

Within RubiCRM, the contact's Settings section contains a field called Email Validated.

This field represents whether the email address associated with the contact record has been validated.

Validation of the email address is important before the contact should be able to use any online services you provide.

Validating the email address ensures that emails are being sent to the correct place. This creates a step to ensure that the user or staff member has not entered the incorrect email address, whether due to a spelling mistake or a genuine wrong email address input.

The following steps assume a querystring link is used to validate the email address.

Steps for Validating

Step 1

When a contact tries to log in to your website, the application should call api/Login. This API call will return LoginVerified, which is a bit value telling you if the email has been validated.

Step 2

If LoginVerified is false, you must take the ValidationVal and ValidationID returned within the same api/Login call just made.

The ValidationVal and ValidationID are valid for 1 hour. You will be required to store the ValidationVal and ValidationID for a future step.

Step 3

Send an email to the contact using the email address on file for them.

This email will act as a validation email, which should ask them to validate their account.

Within this email, you should input the ValidationVal and ValidationID into a querystring URL that acts as a validation button.

Step 4

Once the user validates their email address by clicking the validation button, retrieve the ValidationVal and ValidationID from the querystring.

Pass the ValidationVal and ValidationID to the API call api/Validation.

Step 5

If the api/Validation returns true based on the provided ValidationVal and ValidationID, calling api/Login again will result in LoginVerified being true.