Help
Team & roles
Bring people onto your business without sharing your login. Give each person exactly the access they need, from a ready-made role or one you build yourself, and change it any time.
View as Markdown (for LLMs / AI agents)What it is
Every person you bring onto a business gets their own login and their own role. A role is a named set of permissions - what that person can view and what they can change, across payments, payouts, products, team management, and your developer settings (API keys, webhooks, authorized domains). Nothing they can do is inherited from you; it comes entirely from the role they were given.
The Owner role
Whoever creates a business automatically becomes its Owner, with every permission there is. The Owner role always keeps every permission and can never be deleted - a business can invite more Owners, but it can never end up with none. An Owner can hand off their own role to something else, but only once at least one other Owner exists, so nobody can accidentally lock everyone out of running the business.
Quick-start roles
Five ready-made roles cover the common cases. Add any of them from Team with one click, then rename it or adjust its permissions to fit exactly how your business works:
Owner
Full access to everything. Always at least one per business.
Developer
API keys, webhooks, authorized domains, and reporting - not payouts or team management.
Financial Auditor
Read-only: payments, payouts, wallet balance, and reports.
Manager
Day-to-day running of the business - payments, payouts, recurring plans, products, and promo codes.
Customer Care
Payments and reports only, for handling support questions without touching money movement or settings.
Custom roles
Prefer to build one from scratch, or rename "Manager" to "Store Lead" and remove the permissions you don't want it to have? Custom roles work the same way: a name and a checklist of permissions, grouped by area (payments, payouts, recurring, products & promo codes, reports, team, settings, and developer tools). Change a role's permissions any time - everyone holding that role picks up the change immediately, with no need to re-invite them or ask them to log back in.
Inviting someone
From Team, choose Invite, enter the person's phone number or email, and pick a role. They get a link by SMS or email to accept it.
POST /v1/business/team/invite
X-API-Key: uk_live_...
{ "phone": "255712345678", "role_id": "role_xxxxx" }If they don't have an account yet
You can invite someone by phone or email even if they've never used Ultraner before. The invite waits for them - as soon as they sign up with that same phone number or email, it's ready for them to accept, no extra step on your side.
Changing roles and removing people
Change anyone's role, or remove them from the business, at any time from Team. The only rule is the Owner safeguard above: you can always remove or demote anyone except the last remaining Owner. Someone can also remove themselves from a business they no longer work with, subject to that same rule.