# Inviting people into an organization

> `osyrin org invite ada@example.com --role Admin --org acme` mails Ada a link; she needs no account yet, and she joins the organization with that role when she accepts. `osyrin org add-user` adds only somebody who already has an account. Only an Owner invites an Owner.

<!-- id: zones-inviting-people-into-an-organization · area: zones · stability: preview · html: https://osysharp.com/reference/zones/inviting-people-into-an-organization/ -->

## Summary        {#summary}

`osyrin org invite <email> --role <role> --org <org>` is the People page's invite form as a command: an invitation is
mailed to the address, and the person joins when they accept — through the link, which makes their account if they have
none, or signed in, if they do.

## Signature      {#signature}

```console
osyrin org invite <email> [--role Owner|Admin|Member] [--org <slug>] [--server <url>] [--json]
```

## Description    {#description}

**The role is the organization's.** Owner, Admin or Member — left out, Member. The invitation carries it, and accepting
gives it. A platform role is never handed out this way.

**Who may invite whom.** An organization's Owners and Admins invite into it; only an Owner invites an Owner; a Member
invites nobody. A plan may limit how many people an organization holds — waiting invitations count — and the refusal
says so, with how to make room.

**Already has an account?** `osyrin org add-user <email> --role <role>` adds them at once instead. It answers
*"Platform user … not found"* for an address with no account; invite that one.

- `--org` — the organization; needed when you belong to more than one.
- `--json` — prints `{ok, invitation, organization, email, role}`.

## Examples       {#examples}

```console
osyrin org invite ada@example.com --role Admin --org acme --server https://osyrin.app
osyrin org list-users --org acme --server https://osyrin.app
```

## See also       {#see-also}

[Asking Claude to run your Osyrin account](https://osysharp.com/reference/local/asking-claude-to-run-your-osyrin-account/) — asking Claude to manage people for you.

[An organization's environments](https://osysharp.com/reference/zones/environments-of-an-organization/) — where the organization's apps run.