Skip to main content
Send secure verification URLs to your applicants — via email, SMS, or any channel you choose. No frontend development needed.
A verification link is a unique, secure URL that takes your applicant directly into a verification flow hosted by deepidv. You configure the checks in a workflow, and deepidv handles everything the applicant sees — document capture, liveness prompts, data collection, and more. deepidv supports two types of links: session links (one-time, per-applicant) and permalinks (reusable, persistent).

​
How It Works

1

Set up your workflow

In the Admin Console, drag and drop the services you need into a workflow. Each workflow gets a unique workflowId.
2

Generate a verification link

Create a session for your applicant — either no-code from the Admin Console, or programmatically via a single API call to the Create Session endpoint. Each session produces a unique verification URL.
3

Share the link

Send the URL to your applicant through any channel — email, SMS, in-app message, or hand it off directly. deepidv can also send the invite automatically via email and SMS.
4

Get results

Once the applicant completes the flow, results are available immediately in the Admin Console and via the Retrieve Session API.
Every session created through the API or Admin Console generates a unique, one-time verification link. This link is tied to a single session and a single applicant. When you create a session, the link is returned in the response: 
{
  "idv_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "session_url": "https://app.deepidv.com",
  "links": []
}
If you enable email or SMS invites, deepidv automatically sends this link to the applicant for you.

​
Method 1: No-code (via Admin Console)

The fastest way to get started — no developer resources required.
  1. Navigate to Sessions in the Admin Console
  2. Click + Create Session
  3. Select the workflow you want to use
  4. Enter the applicant’s details (name, email, phone)
  5. The session is created and the invite is sent automatically

​
Method 2: Via API

The standard approach for automating verification links inside your application. Send a POST request to the /v1/sessions endpoint with your API key and applicant details: 
curl -X POST https://api.deepidv.com/v1/sessions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@example.com",
    "phone": "+14165557890",
    "workflowId": "your-workflow-id"
  }'
The API returns the idv_id and session_url: 
{
  "idv_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "session_url": "https://app.deepidv.com",
  "links": []
}
Full endpoint details are available in the Create Session API Reference.

​
Delivery Controls

Control how the verification link reaches your applicant:
ParameterDefaultDescription
sendEmailInvitetrueSends the verification link to the applicant’s email address
sendPhoneInvitetrueSends the verification link to the applicant via SMS
Set either to false if you’d rather deliver the link yourself: 
curl -X POST https://api.deepidv.com/v1/sessions \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@example.com",
    "phone": "+14165557890",
    "sendEmailInvite": false,
    "sendPhoneInvite": false,
    "workflowId": "your-workflow-id"
  }'
The session_url in the response gives you the link to share however you prefer — embed it in your app, paste it into a chat, or build your own email template.
Permalinks are persistent, reusable verification links tied to a specific workflow in your organization. Unlike session links, they don’t expire after a single use — each time an applicant opens a permalink, a new session is created automatically.
  • Embed on your website — place a link on a landing page so applicants can start verification on their own
  • Onboarding flows — include a consistent link in welcome emails or signup sequences
  • Repeat verifications — let applicants re-verify without your team generating a new session each time
  • In-person scenarios — display as a QR code at a branch, event, or physical location
Why use verification links

Launch in hours

Go from zero to a live, compliant verification flow without writing any frontend code.

No UI to maintain

deepidv handles the entire applicant-facing experience — document capture, liveness, data collection, and guidance.

Send via any channel

Deliver links through email, SMS, WhatsApp, support chat, in-app messages, or embed directly on your site.

Works in-person too

Generate a QR code for walk-in scenarios where applicants need to verify on their own device.

​
Next Steps

  • Build your first workflow — head to the Admin Console to design your verification flow
  • Set up your API key — see the Authentication guide to start creating sessions programmatically
  • Review session results — learn how to review and manage sessions in the Manual Review guide