Organizations & members
Accounts, organizations, the two roles, and how to invite your team.
Your account is you — the email or GitHub/Google/Linear identity you sign in with. An organization is the shared tenant your team works in: it owns projects, tasks, runs, connectors, members, and usage. One account can belong to any number of organizations.
Create or join an organization
Signing up creates only your account. Right after, Peractor takes you through onboarding: create an organization (you become its admin) or join one with an invite link. You can create more organizations later from the dashboard's organization switcher.
Roles
| Role | What it can do |
|---|---|
| Member | Create tasks, start and watch runs, review gates, use every day-to-day surface. |
| Admin | Everything a member can, plus manage members and invites, connectors, project configuration, git access, API keys, and billing. |
Change a member's role or remove a member from Dashboard → Members. Peractor refuses to demote or remove an organization's last admin, so an org can never lock itself out. On mobile, admin-only screens stay visible to members but read-only, with the reason shown at the top.
Invite your team
From Members, create an invite with a role and — optionally —
an email address. With an email, Peractor sends the join link for you;
either way you get a copyable link like
https://peractor.example.com/invite/<token> to share
yourself. The invite page shows the organization and role, asks the
visitor to sign in or create an account, and joins them in one click.
Pending invites can be revoked at any time.
Treat invite links like secrets. A link is redeemable by whoever holds it — the email address only controls where the link is delivered, it is not re-checked when the invite is accepted.
Switching organizations
Every surface has a switcher: the dashboard and desktop app in the sidebar header, the editor extension in its account menu, and the phone apps in the scope menu on Runs and Tasks — organizations listed as sections with their projects underneath. Switching changes what every panel shows; nothing is shared across organizations.
Ways to sign in
Email + password (8 characters minimum), or Continue with GitHub, Google, or Linear where the host has them configured. The editor and desktop app sign in through your browser and receive the session back over a local loopback — you never type your password into the editor. The mobile apps use the system browser sheet the same way.
Beta limits. Password reset by email, changing your email or password, and deleting an account or organization aren't self-serve yet — contact us and we'll help.
Next: Plans & usage · Projects & repositories