> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wavecentric.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# User Invitation

> Onboarding new team members via email invitation.

Admins can invite new users to the platform via a secure email flow.

## Invitation Steps

```mermaid theme={null}
sequenceDiagram
    participant Admin
    participant API as System API
    participant Email as Email Service
    participant Invitee
    
    Admin->>API: POST /users/invite
    API->>API: Generate Secure Token
    API->>Email: Dispatch Invitation
    Email-->>Invitee: "You're Invited" Link
    
    Invitee->>API: Click Activation Link
    API-->>Invitee: Account Verified & Logged In
```

1. **Admin Action**: Admin enters email and permission level (e.g., `admin`, `guest`) in the dashboard.
2. **Token Generation**: A secure, time-sensitive magic link is generated.
3. **Email Delivery**: The user receives a branded "You've been invited" email.
4. **Account Activation**: Clicking the link verifies the email and logs the user in.

<Note>
  Only users with `admin` permissions can initiate this workflow.
</Note>

## API Reference

<Card title="Invite User" icon="envelope" href="/api-reference/users/invite">
  Trigger an invitation email.
</Card>