Ligantic

/

/

/

/

Auth - Space Identity Create

Type identifier: auth:space-identity:create Category: Auth Operations

Description

The Auth - Space Identity Create node creates a new Space Identity within a Space, allowing users to authenticate and access the Space's Experiences. It assigns a role to the Space Identity, determining the user's permissions.

Input Handles

Handle	Type	Description
`trigger`	control	Triggers Space Identity creation.
`displayName`	`string`	(Optional) Display name for the Space Identity.
`claimValue`	`string`	(Shown only when a JWT strategy is selected; required) The value of the strategy's client ID claim that resolves to this Space Identity. 1 to 500 characters.

Output Handles

Handle	Type	Description
`spaceIdentityId`	string	The ID of the created Space Identity.
`success`	control	Triggered when the Space Identity is created.
`error`	control	Triggered when creation fails.

Configuration Options

Option	Type	Default	Description
Authentication Strategy	`string`	required	The authentication strategy.
Space Role	`string`	required	Role to assign to the new Space Identity.

Authentication Strategy

Selects which authentication strategy configuration to use:

Defines Space Identity cohort to add to
For a JWT strategy (see Authenticate Requests with a JWT), the claimValue input is required. A token carrying that claim value authenticates as this Space Identity. A claim value maps to one Space Identity per strategy; creating a second Space Identity with the same value triggers error.

Role Assignment

Assigns a Space role to the Space Identity:

Determines access permissions
Controls Experience visibility
Affects data access rules

Behaviour

Receives trigger with display name (and, for JWT strategies, claim value)
Creates the Space Identity (for JWT strategies, with its claim value)
Assigns specified role
Returns the created Space Identity

Identity Properties

Created Space Identity includes:

Unique ID
Display name
Assigned role
Creation timestamp
Authentication strategy reference

Examples

User Registration

Flow:

Flow - Trigger: Registration form submission
Validate input data
Auth - Space Identity Create: Create the Space Identity
Auth - Magic Link Generate: Create verification link
Integration - SMTP: Send welcome email

Configuration:

Authentication Strategy: (Magic Link strategy)
Space Role: (member role)

Invite User

Flow:

Admin triggers invite
Auth - Space Identity Create: Create invited user
Auth - Magic Link Generate: Create login link
Integration - SMTP: Send invitation email

Assign Different Roles

Configuration varies by use case:

New customer: "customer" role
Team member: "member" role
Administrator: "admin" role

Related pages

Auth - Magic Link Generate

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.

How to Authenticate Requests with a JWT

This guide shows you how to let an external system call a Space's App (for example, an Endpoint, see How to Create an Endpoint) with a bearer JWT issued by its own identity provider.

Integration - SMTP

The Integration - SMTP node sends emails through an SMTP server. It supports various email formats including plain text, HTML, and rich content with automatic text fallback. The node can handle attachments and supports common email features like CC, BCC, and reply threading.

Queries Records based on filter criteria. Supports complex filtering, pagination, and ordering. Returns matching Records with metadata. Results can be processed, displayed, or passed to downstream nodes.