Auth - Magic Link Generate
Type identifier:
auth:magic-link:generateCategory: Auth Operations
Description
The Auth - Magic Link Generate node creates a secure, single-use authentication link that users can click to log in without a password. The link is typically sent via email and expires after a configurable period.
Input Handles
Handle | Type | Description |
|---|---|---|
| control | Triggers link generation. |
|
| The ID of the Space Identity that will log in with this link. |
|
| (Dynamic) Timeout in minutes. Appears only when Timeout is set to dynamic. |
Output Handles
Handle | Type | Description |
|---|---|---|
|
| The generated magic link URL. |
| control | Triggered when link is generated. |
| control | Triggered when generation fails. |
Configuration Options
Option | Type | Default | Description |
|---|---|---|---|
Space Authentication Strategy |
| - | The authentication strategy to use. If not set, a magic link strategy in the Space is used. |
Domain |
| Automatic | The app endpoint used for the link: automatic selection, a verified custom domain, or the Ligantic app endpoint. |
Override Success Experience |
| - | Custom Experience to redirect to after login. |
Timeout |
|
| Time to live in minutes, configurable as a literal value or dynamic input. Values outside 1 to 2880 minutes cause the node to fail. |
Authentication Strategy
Selects which authentication strategy configuration to use:
- Defines Space Identity cohort to use
Success Experience Override
Optionally redirect users to a specific Experience after successful authentication, overriding the Authentication Strategy's default.
Select the empty "Select experience..." option to remove an override and use the Authentication Strategy's default again.
Timeout
Controls how long the generated magic link remains valid.
- Default: 60 minutes
- Minimum: 1 minute
- Maximum: 2880 minutes (48 hours)
- Whole minutes only
- Dynamic mode: exposes a top input handle so the Flow can supply the timeout at runtime
- Invalid values: cause the node to take the
errorpath
Behaviour
- Receives
triggerandspaceIdentityId - Uses the Timeout value, or the top input when Timeout is dynamic
- Creates a magic link URL for the Space Identity that is valid until the timeout expires
- Returns the magic link URL on
magicLinkand triggerssuccess
The node triggers error instead when no magic link strategy is available in the Space, when no verified domain or Space name is available to build the link, when spaceIdentityId is not a valid ID, or when the timeout is invalid.
Flows v2
Connect trigger and spaceIdentityId, and connect timeoutMinutes when Timeout is dynamic. Link generation requires the control path to reach this node; requesting its data output alone does not generate a link.
The generated link is sensitive. Downstream nodes, including email templates, can use its string value. Flow Result may return it from an inline child Flow to the caller, but cannot return the link or sensitive values derived from it as the top-level Flow run result.
The output handle shows a Sensitive badge. Hover over the badge or focus it with the keyboard to inspect the source declaration. Run inspection shows the observed trait, but the link value remains unavailable, including in raw-output mode.
Link Format
Generated links follow this structure:
https://<domain>/__auth/ml?t=<token>Token Properties
- Cryptographically random
- Single-use (invalidated after use)
- Time-limited expiration
- Bound to specific Space Identity
Examples
Basic Magic Link Login
Flow:
- Flow - Trigger: User submits email
- Auth - Space Identity Create: Create a new Space Identity
- Auth - Magic Link Generate: Create link
- Integration - SMTP: Send email with link
- UX - Message: Confirm email sent
Custom Landing Experience
Configuration:
- Override Success Experience:
dashboardexperienceid
Use case: Direct users to a specific page after authentication.
Registration Flow
Flow:
- Collect user registration data
- Create a new Space Identity
- Auth - Magic Link Generate: Create verification link
- Send welcome email with link
- User clicks link → verified and logged in