Team invites & enterprise invites
Skilladder provisions people through two different invitation styles. Both use one-time links that expire — this is deliberate so old email threads cannot reactivate stale access.
:::tip Quick distinction
- Team invite → "Join my company's Skilladder account as a staff member."
- Enterprise invite → "Set up the primary contact account for a new enterprise company."
:::
Company team invites
What happens for the recipient
- The primary company administrator (or a Platform admin) sends an invite from Account Settings → Team with the new person's name, email, and role.
- The new person receives an email with an invite link.
- The invite page shows the company name, who sent it, and the role they're being added as — or a clear error if the link is expired or invalid.
- New users set a password and are then directed to sign in.
- Existing Skilladder users receive a notification email instead — they already have credentials and are just being added to the company roster.
Why it works this way
| Design choice | Why |
|---|---|
| Token in the URL | Proves the recipient controls the inbox the admin typed — no separate verification step needed |
| Primary admin sends | Only the primary company administrator or a Platform admin can send team invites — deputies can see the Team tab but cannot invite new people unless the product policy changes |
| Email must match | If the recipient is signed in to Skilladder under a different email than the one the invite was sent to, they'll see an email mismatch message — the fix is to sign out and reopen the invite link |
| Link expiry | Short-lived links reduce risk if an inbox is later compromised; treat "invite expired" as normal, not a bug |
Common escalations
| Symptom | First step |
|---|---|
| "Wrong account" or email mismatch on accept | Sign out completely, reopen the invite link in a fresh session, verify the inbox matches the address used when sending |
| Link expired | Send a fresh invite from Team settings; confirm the email address spelling |
| No email received | Check spam; try resending; confirm the address isn't a group alias that strips links |
Enterprise invites
What happens
Enterprise invites are used when Skilladder is onboarding the named primary contact at a new enterprise company — for example, after a contract is signed.
A Platform admin creates the invite and sends it to the designated contact. The recipient:
- Opens the invite link from the onboarding email
- Follows the setup screens (account creation, password, and any legal acknowledgements)
- Signs in as the new company's primary administrator
The invite link expires after a set number of days. If it expires before the recipient acts, a new invite must be issued by the Platform admin — there is no self-serve extension.
Why it's separate from team invites
| Reason | Explanation |
|---|---|
| Different risk profile | Enterprise onboarding may pair with contractual verification steps, not just adding a colleague |
| Traceability | The invite record ties to company provisioning, making it easier for support to trace onboarding history if questions arise later |
| Distinct email templates | Enterprise invite emails use a different template so deliverability and engagement can be tracked separately |
If something goes wrong
When escalating an enterprise invite issue to #producttech_cooking, include:
- The company name and the email address the invite was sent to
- Whether the link showed an error or just didn't arrive
- Approximate time the invite was sent
Cross-cutting reminders
- Assessment participant links (
/invites/...) are documented under Assessment invites — they are not the same as team or enterprise onboarding links. - For permission details (who can invite whom), see Capabilities matrix.
- All invite types expire — never promise permanent links during sales conversations without engineering sign-off.