Skip to main content
POST
/
humanverification
/
send-email
curl -X POST https://api.yourservice.com/api/v1/humanverification/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "reviewerEmail": "priya.sharma@techcorp.com",
    "reviewerName": "Priya Sharma",
    "skillCount": 2,
    "reviewLink": "https://review.yourservice.com?recordVerificationId=ver_live_abc123&reviewerToken=uuid-token",
    "expiresAt": "2025-05-09T10:00:00.000Z"
  },
  "message": "Reviewer email sent successfully",
  "executionTime": "320ms"
}

​
Overview

Generates a reviewer token (valid for 30 days), sends an email to the reviewer with a unique review link, fires a verification.initiated webhook, and increments your API key’s credit usage. Each call to this endpoint invalidates any previously issued token for the session and generates a fresh one.
Requires a valid session token via the x-api-key session middleware. All required data (reviewer, skills, session) is read from the session — no additional fields are needed in the request body.

​
Prerequisites

All of the following must be completed before calling this endpoint:
  • ✅ Reviewer details stored via POST /storereviewerdetails/store
  • ✅ Skills stored via POST /step1/storeskills/store
  • ✅ Verification items stored via POST /step3/store-verification-items/store

​
Response

​
data
object

​
Error Codes

CodeHTTPDescription
MISSING_VERIFICATION_ID400No recordVerificationId found in session
REVIEWER_NOT_FOUND404No reviewer details stored for this session
NO_SKILLS_FOUND404No skills found for this session
VERIFICATION_NOT_FOUND404No aggregated verification data could be resolved
EMAIL_SEND_FAILED500Email constructed but failed to send via AWS SES
INTERNAL_ERROR500Unexpected server error
curl -X POST https://api.yourservice.com/api/v1/humanverification/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "reviewerEmail": "priya.sharma@techcorp.com",
    "reviewerName": "Priya Sharma",
    "skillCount": 2,
    "reviewLink": "https://review.yourservice.com?recordVerificationId=ver_live_abc123&reviewerToken=uuid-token",
    "expiresAt": "2025-05-09T10:00:00.000Z"
  },
  "message": "Reviewer email sent successfully",
  "executionTime": "320ms"
}