Organizations
How a WhatsApp number, API key, or webhook is owned, and how to let other people manage it.
A WhatsApp number, an API key, and a webhook all belong to an organization (a shared workspace), not to one person. You get access to those resources by being a member of the organization that owns them. That is how several people can manage the same WhatsApp connection.
Your personal organization
When you sign up, an organization is created for you automatically, and you are its owner. If you work alone you never have to think about it: everything you create lands in that one organization.
It starts to matter when you want a second person on a connection, or when you want to keep separate projects apart.
Letting someone else manage a connection
To give a teammate access to one of your numbers, you do not share your login or copy an API key to them. Instead you invite them into the organization that owns the number. When they accept, they become a member and can see that organization's WhatsApp sessions, API keys, and incoming events.
Each member has a role that decides what they are allowed to do:
| Role | What they can do |
|---|---|
owner | Everything an admin can do, plus manage members and delete the organization. |
admin | Manage the organization's sessions, API keys, and webhooks, and invite people. |
member | Read messages and send messages. Cannot change settings or membership. |
Switch between organizations
One person can be a member of more than one organization. The organization switcher in the dashboard header shows the organization you are working in. Open it to pick another one. The selected organization owns any new resource you create, and the gateway checks your access against it.
When no organization is selected, the switcher reads Select organization and the workspace pages ask you to pick one.
Create another organization
Create a separate organization to keep projects apart, each with its own WhatsApp numbers, API keys, and webhooks.
- Open the organization switcher and select Create organization.
- Enter a Name of up to 80 characters.
- Select Create organization. You become the owner, and the dashboard switches to the new organization.
You cannot add members from the dashboard yet. The Members item in the organization switcher is marked Coming soon. Members, roles, and email invitations exist in the backend, but the screens for sending and accepting an invitation ship in a later release. Until then, each organization has one member: the person who created it.
Organization administrators
An organization admin manages that workspace. This role does not grant
platform-wide account or infrastructure access. Your host may have platform
administrators who can oversee sessions across organizations.