Documentation Index
Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
Use this file to discover all available pages before exploring further.
What Is a Magic Link?
A Magic Link is a URL that allows users to start identity verification immediately — no login or account required. Share the link via email, SMS, or embed it on your site.Key Features
| Feature | Description |
|---|---|
| Single-use | Link becomes invalid after one verification. Ideal for individual invites. |
| Multi-use | Link stays active for a set number of uses (e.g., 100). Best for campaigns. |
| Unlimited | Link stays active until manually deactivated or it reaches its expiration date. |
| Expiration | Optional — automatically disables the link after a specific date and time. |
Usage logic:
- Every click reduces the link’s limit, even if the user quits early. You are only billed for completed verifications.
- Links cannot be extended or refreshed. Once expired or at limit, create a new one.
Sharing and Use Cases
Once generated, the Magic Link URL is ready for distribution:- Direct messaging — Send via email or SMS for personal invites.
- Website integration — Embed behind a “Verify Now” button on your site.
- QR codes — Convert the URL to a QR code for in-person verification.
The User Experience
When a user clicks the Magic Link:- Validation — System checks the link is active, not expired, and your account has credits.
- Redirection — The system creates a new verification session and your user enters the verification flow.
- Completion — User uploads documents and selfie without needing passwords or accounts.
How to Create a Magic Link
Go to Settings
Log in to your dashboard. From the left menu, go to ID Verification → Settings → Magic Link.
Configure Settings
- Name — Internal identifier for this link.
- Verification Flow — Select steps (document verification, selfie, or both).
- Usage Limit — Single-use, multi-use, or unlimited.
- Expiration — (Optional) Set a date/time for the link to stop working.
- Language — Pre-select the interface language.
- Custom theme — (Optional) Enable the toggle and select a branding theme to apply to sessions started from this link. If not set, the Default theme is used. See Branding (KYC).
Automation and Results
Viewing Results
Outcomes are updated in real-time. View the status and details of every session in your iDenfy Dashboard.Webhooks
For automated workflows, Magic Links can be paired with webhooks. When a user completes verification via a link, results are automatically pushed to your backend. To enable this: