Skip to content

Inviting a user to your workspace

Invite teammates to a workspace so they can help manage your sites, billing, and settings. You send an invitation by email; the person you invite doesn't need a SuperSpace account first — one is created for them when they accept.

Before you start

  • You must be a Workspace Admin on the workspace. If you don't administer the workspace, the Invite button isn't shown.
  • The email address of the person you want to invite.
  • Decide which role they should have. Roles control what the person can do once they join — see the role comparison shown on the invite screen, and the fuller roles and permissions guide for detail.

Send an invitation

  1. Switch to the workspace. Make sure the workspace you want to invite someone to is the active one. Open the account switcher in the left sidebar (the floating Workspaces panel) and select the workspace; this switches your active workspace and opens its page. Use View All in that panel if you need the full list first.

  2. Find the Users card. On the workspace page, scroll to the Users card (subtitled User Management and Access). It lists everyone who already has access. Click Invite in the card's header.

  3. Enter the email and role. On the invitation form, type the person's address in the Email field, then choose a Role. The comparison table below the form explains what each role can do — its columns are Billing Manager, Site Viewer, Site Manager, Site Admin, and Workspace Admin.

  4. Send it. Click Invite user. Because inviting someone is a sensitive action, you may be asked to re-confirm your identity with your passkey or password before it sends. You'll then return to the workspace page with a confirmation that the invitation was sent, and the pending invite now appears in the Users card.1

The new invitation shows in the Users card under Pending Invitations, with its role, when it was sent, and when it expires. From there you can Re-send the email or Cancel the invitation before the person responds.

You can send the same invitation through the API by creating a role on the workspace. Pass the email and the user_role_id of the role to grant. The role ids aren't fixed, so look them up first with GET /api/user_roles and use the id of the role you want:

curl -X POST \
  -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  -d "email=user@example.com" \
  -d "user_role_id=$USER_ROLE_ID" \
  https://control.superspace.nl/api/accounts/$ACCOUNT_ID/roles

A success returns 202 Accepted and emails the invitation. The caller must administer the workspace. See Accounts for the roles and user_roles endpoints, and Users for the user reference.

What the invitee receives

The person you invite gets an email titled Accept invitation, telling them who invited them and to which workspace, with an Accept invitation button.

  • If they're new to SuperSpace, the button takes them to set a password and create their account, then drops them into the workspace.
  • If they already have a SuperSpace account, the button takes them to their Workspaces page to accept.

Accepting from inside SuperSpace

An existing user can also accept without the email. When they sign in, a Workspace Invitations card appears at the top of their Workspaces page listing each pending invite with Accept and Decline buttons. Accepting adds the workspace to their account with the role you chose; declining removes the invitation.

Invitations expire after one week

A pending invitation is valid for 1 week. If it lapses before the person accepts, send a new one — open the Users card and use Re-send, or invite them again.

Next steps

  • Confirm the new member appears in the workspace's Users card once they accept
  • Review what each role can do before granting Workspace Admin, which has full access including managing other users and billing

  1. Only Workspace Admins can send, re-send, or cancel invitations. Roles granted on a parent workspace also cascade down to its sub-workspaces, so a member may already have inherited access without a direct invitation. ↩