Skip to main content

​
Overview

Email verification provides email validation through:
  • Ownership Verification: Confirm users own the email address via OTP
  • Risk Assessment: Analyze email addresses for fraud indicators
  • Deliverability Testing: Verify email addresses can receive messages

​
Configuration

{
  "settings": [
    { "fieldName": "EMAIL_COMPANY_NAME", "value": "Your Company Name" },
    { "fieldName": "EMAIL_RISK_THRESHOLD", "value": 75 }
  ]
}

​
Verification Process

1

Email Address Input

User provides their email address
2

Risk Analysis & OTP Delivery

System analyzes email and sends verification code automatically
3

OTP Verification

User enters the received verification code to complete verification

​
API Integration

​
Step 1: Submit Email Address

Endpoint: POST /api/v1/verifications/{verificationId}/send-inputs 
curl -X POST https://api.urtentic.com/api/v1/verifications/{verificationId}/send-inputs \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "X-CLIENT-ID: ${CLIENT_ID}" \
  -F 'inputs=[{"fieldName":"EMAIL_ADDRESS","value":"[email protected]","type":"TEXT"}]'
After submitting the email address, an OTP is automatically sent to the provided email. The user must enter this code to complete verification.

​
Step 2: (Optional) Resend OTP Code

const otpResponse = await fetch(`/api/v1/workflows/${workflowId}/email-otp`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'X-CLIENT-ID': CLIENT_ID,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ key: "[email protected]" })
});

if (otpResponse.status === 204) {
  console.log("OTP sent successfully");
}

​
Step 3: Get Verification Results

Endpoint: GET /api/v1/verifications/{verificationId} 
{
  "id": "85c94e71-6e3f-4a19-b15c-781d8a876542",
  "flowId": "db50ed08-18fa-41e8-9e46-a44aca39f69d",
  "status": "COMPLETED",
  "steps": [
    {
      "stepId": "EMAIL_CHECK",
      "status": 1,
      "data": {
        "risk_score": 15,
        "verification_status": "VERIFIED"
      }
    }
  ]
}

​
Webhook Notification

{
  "eventName": "step_completed",
  "flowId": "db50ed08-18fa-41e8-9e46-a44aca39f69d",
  "timeStamp": "2024-01-10T10:32:00.000Z",
  "resource": "/api/v1/verifications/85c94e71-6e3f-4a19-b15c-781d8a876542",
  "metadata": { "userId": "user_12345" },
  "id": "EMAIL_CHECK",
  "status": 1,
  "data": {
    "risk_score": 15,
    "verification_status": "VERIFIED"
  }
}

​
Implementation Tips

  • Explain the verification process before starting
  • Show clear feedback when OTP is sent
  • Make OTP input fields mobile-friendly
  • Provide resend option with rate limiting
  • Handle rate limiting errors gracefully (429 responses)
  • Set appropriate OTP expiration times
  • Log verification attempts for audit purposes
  • Obtain proper consent for email communications
  • Validate email format client-side before submission
  • Handle email delivery failures with retry logic
  • Check spam folders if delivery appears delayed
  • Implement proper timeout handling for OTP requests