Creating Verification Links

Learn how to create verification links through the dashboard and programmatically via the API. Configure verification types, add-ons, email delivery, result translations, and more.

Via Dashboard

The quickest way to create a verification link is through the Owl Eyes dashboard. Navigate to Create Link in the sidebar to access the verification wizard.

Step 1: Select Verification Type

Choose the verification level that matches your security requirements. Each tier builds on the previous one:

TypeWhat's IncludedPriceBest For
Document OnlyDocument OCR, authenticity verification, expiry check$0.35Low-risk scenarios, data extraction
Document + SelfieEverything in Document Only + selfie capture + face matching$0.50Medium-risk transactions, account creation
Document + Selfie + LivenessRECOMMENDEDEverything in Standard + active liveness detection + anti-spoofing$0.75High-value transactions, financial services
Premium (NFC)Everything in Enhanced + NFC chip reading + cryptographic verification$1.25Maximum security, government-grade verification
Recommendation
We recommend Document + Selfie + Liveness for most use cases. It provides robust protection against spoofing and deepfakes while maintaining a smooth user experience.

Step 2: Add-ons (Optional)

Enhance your verification with specialized capabilities. Add-ons are charged in addition to the base verification price.

Multi-Script OCR

Enhanced OCR for non-Latin scripts including Arabic, Cyrillic, Chinese, Japanese, Korean, and more.
+$0.25

Deepfake Detection

AI-powered detection of synthetic or manipulated media, including AI-generated faces and doctored documents.
+$0.30

Age Attestation

Verify minimum age requirements (e.g., 18+, 21+) without storing the user's date of birth. Privacy-preserving.
+$0.20

Voice Biometric

Voice pattern analysis for additional identity verification. Useful for phone-based authentication flows.
+$0.35

Step 3: Customization

Fine-tune the verification experience to match your brand and workflow requirements.

Sender Name

Display your company name on the verification page so users know who is requesting their identity verification.

Business Verification Required
To customize sender names, your business must be verified through our KYB (Know Your Business) process. Verified businesses display a trust badge next to their name, helping protect recipients from impersonation attempts.

Learn about business verification →

Link Expiration

Set how long the verification link remains valid:

OptionUse Case
24 HoursUrgent verifications, high-security transactions
7 Days (default)Standard onboarding, most common use case
30 DaysLow-urgency verification, employment screening
NeverEvergreen links, use with caution

Results LanguageNEW

Receive verification results translated into your preferred language. The original document is processed and OCR'd in its native language, then the extracted data is automatically translated.

Example use cases:

  • Receive Korean passport data translated into Spanish
  • Process Japanese driver's licenses with results in French
  • Verify Arabic IDs with English result output
  • Handle Chinese documents for German-speaking support teams

Supported languages include: English, Spanish, French, German, Italian, Portuguese, Japanese, Korean, Chinese (Simplified), Chinese (Traditional), Arabic, Russian, Hindi, and many more.

Single Use Only

When enabled, the verification link can only be used once. After a user completes (or attempts) verification, the link becomes invalid. This is the default and recommended setting for most use cases.

Send Email via Owl EyesNEW

Let Owl Eyes send the verification request email directly to your recipients. This saves you from implementing your own email infrastructure and ensures a professional, trusted delivery.

What's Included in the Email
  • Verification link with secure one-click access
  • Your verified business name with trust badge (if verified)
  • Security warnings about phishing and fraud
  • Link for recipients to report suspicious activity

Enter one or more recipient email addresses, separated by commas. Each recipient receives their own verification request email.

Email Deliverability
If recipients don't receive the email, advise them to check their spam or junk folder. Emails are sent from verification@updates.owl-eyes.com.

Step 4: Advanced Options (Optional)

Configure webhooks and redirects for seamless integration with your application.

Webhook URL

Receive real-time notifications when a verification is completed. Enter your server endpoint and we'll POST the verification results as soon as they're ready.

Example Webhook URLtext
Loading...

Learn more about webhooks →

Redirect URL

After the user completes verification, redirect them to a page in your application. We append query parameters with the verification result.

Redirect URL with Parameterstext
Loading...

Pricing Summary

Before generating the link, you'll see a summary showing:

  • Selected verification type and its base price
  • Any add-ons you've selected with their prices
  • Total cost per verification

Click “Generate Verification Link” to create your link. You'll be able to copy it, share via email or WhatsApp, or generate a QR code.

Via SDK

Create verification links programmatically using the Owl Eyes SDK. This is ideal for automating link creation in your backend systems.

create-verification.tstypescript
Loading...
API Access Required
The Node SDK requires API access. Request access if you haven't already.

SDK Options Reference

OptionTypeDescription
typestring"document_only" | "standard" | "enhanced" | "premium"
expires_instring"24h" | "7d" | "30d" | "never"
single_usebooleanLimit link to single use (default: true)
redirect_urlstringURL to redirect user after completion
webhook_urlstringURL to receive webhook notifications
target_languagestringISO language code for result translation (e.g., "es", "fr", "ja")
addonsstring[]Array of add-on IDs to enable
send_emailbooleanSend verification request email via Owl Eyes
recipient_emailstringEmail address(es) for verification request (comma-separated)
sender_namestringCustom sender name (requires business verification)
reference_idstringYour internal ID to track this verification
metadataobjectCustom key-value pairs (max 10 keys)

Link Response

When you create a verification link, you receive a response containing:

Verification Responsejson
Loading...

Bulk Creation

Need to create many links at once? Use the bulk creation endpoint:

bulk-create.tstypescript
Loading...

Bulk creation supports up to 100 verifications per request.