Onboard an organisation
Add an organisation with its plan, first admins and company sign-in, then follow it until it's set up.
Each organisation on a hosted portal has its own sign-in, members, design systems and plan, kept apart from every other. You add one with Onboard in the operator console. Nothing is created until the last step.
Add the organisation
- Go to Operator console › Onboard (
/operator/onboard). - Organisation: enter its Name. The Slug follows the name; it appears in sign-in links and can't change later. Add its Email domains (optional), one per line: sign-in finds the organisation from these.
- Plan: choose a plan, or No plan for now (every feature, no limits, not billed). Add a Billing email and Billing reference, such as a purchase order, if you have them.
- Admins: enter the First admins (optional), one work email per line. They get an invitation and become admins at their first sign-in.
- Sign-in: choose Later, or Now to enter its identity provider's Issuer URL, Client id and Client secret. Its identity provider registers the redirect URI shown on the step.
- Review: check the details and choose Create organisation.
The last screen lists each admin's invitation and whether it was sent. If an email couldn't be sent, it shows the link to pass on yourself; the link works only for that address.
After creating it
Choose Open and the organisation's name to see its page:
- Overview: usage against its plan, requests by day, and an onboarding checklist worked out from what it has done.
- Plan and billing: change its plan and billing contact, and see its issued statements.
- Features: each feature as its plan says, or turned on or off for this organisation alone.
- Settings: its name and domains, Set up company sign-in, Add an admin, Start support session (once its admin grants access) and Suspend organisation.
- Activity: its latest audit entries, with a link to the full audit log.
The organisation's admins then follow their own checklist (Set up your organisation). The console's Overview flags an organisation with no admin a week after it was added.
Suspend an organisation
Suspend organisation signs everyone in it out, and nobody can sign in until you choose Reactivate organisation. Its published design systems keep loading in products.
If something goes wrong
| What you see | What to do |
|---|---|
| Company sign-in wasn't saved | Set it up again from the organisation's Settings with Set up company sign-in. |
| An admin never got the invitation | Use Add an admin on its Settings tab to send it again, or pass on the link it shows. |
| "Enter a slug of lowercase letters…" | Use lowercase letters, digits and hyphens, starting with a letter. |
| No plans to choose from | Create them under Plans, or carry on without one (Plans, usage and statements). |