Appearance

Invite a user ​

Add someone to your account by email. They receive a link, sign in (or sign up) with their email, and land in your account at the role you selected.

Prerequisites: You must be an OWNER or ADMIN. The invitee's email address.

In the console ​

  1. Go to app.smplkit.com.
  2. In the sidebar, click Account → Users.
  3. Click Invite user.
  4. Enter the invitee's email address.
  5. Pick a role: VIEWER, MEMBER, or ADMIN. ADMINs can only invite as VIEWER or MEMBER; OWNERs can invite at any non-OWNER role.
  6. Click Send invitation. The invitee gets an email containing a sign-in link with the invitation token.

The new pending invitation appears in the Users page with status Pending. You can revoke or resend it from the row's actions menu.

Via the API ​

bash
curl -X POST https://app.smplkit.com/api/v1/invitations \
  -H "Authorization: Bearer $SMPLKIT_API_KEY" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "invitation_bulk",
      "attributes": {
        "invitations": [
          {"email": "alice@example.com", "role": "MEMBER"},
          {"email": "bob@example.com",   "role": "VIEWER"}
        ]
      }
    }
  }'

The endpoint accepts up to 50 invitations in one call. Existing-user duplicates and already-pending duplicates are skipped silently — the response is the array of newly-created invitation resources.

role must be one of MEMBER, ADMIN, VIEWER. Inviting as OWNER is rejected.

What the recipient sees ​

The invitation email contains a link of the form:

https://app.smplkit.com/sign-up?invitation_token=<token>

Or /sign-in?... if the invitee already has a smplkit account. When they click:

  1. They land on the sign-in / sign-up page with a banner showing your account name and the role they're being invited to.
  2. They sign in with Google, Microsoft, or email/password (or sign up if they don't have an account).
  3. After authentication, they land at the home page; the invitation token is automatically consumed via POST /api/v1/invitations/accept, joining your account at the invited role.

If they discard the email, the invitation stays pending until you revoke it or it expires.

Revoke or resend ​

In the console, the Users page shows pending invitations alongside accepted users. Each row has a menu with Resend and Revoke actions.

Via the API:

bash
# Revoke (cancels the invitation; the token stops working)
curl -X POST https://app.smplkit.com/api/v1/invitations/$ID/actions/revoke \
  -H "Authorization: Bearer $SMPLKIT_API_KEY"

# Resend (re-issues the email; same token)
curl -X POST https://app.smplkit.com/api/v1/invitations/$ID/actions/resend \
  -H "Authorization: Bearer $SMPLKIT_API_KEY"

Limits ​

  • 100 pending invitations per account.
  • 25 users per account. Pending invitations don't count, but accepted users do.

Hitting either returns 409 Conflict.

Verify ​

After the invitee accepts:

  1. The Users page shows them with Active status.
  2. The pending invitation row is gone.
  3. They can sign in and access resources at their assigned role.

You can confirm the role via the API:

bash
curl https://app.smplkit.com/api/v1/users \
  -H "Authorization: Bearer $SMPLKIT_API_KEY"

The user's role attribute reflects the role you assigned.