Guides
Organizations and teams
Organizations keep domains, API keys, contacts, usage and billing apart. Invite your team with roles, switch between organizations and, on a paid plan, create more of them.
An organization is a separate Pidgely workspace: its own domains, API keys, templates, contacts, webhooks, sending quota, usage and plan and billing. Nothing is shared between organizations, so they fit separate products, brands, clients or environments (production and staging).
Every account starts with one organization, created at sign-up on the Free plan, in sandbox. One login can belong to several organizations.
Roles
| Role | Can |
|---|---|
| Owner | Everything an admin can, plus making or removing owners and deleting the organization. An organization always keeps at least one owner. |
| Admin | Manage domains, API keys, webhooks, templates, contacts, the plan and billing, and the team (invite, change roles, remove). Review the access log. |
| Member | View everything and send e-mails and broadcast tests. Cannot change settings. |
Invite people under Settings → Team in the dashboard. Invitations are e-mailed, expire after 7 days and can be resent or revoked. Anyone can leave an organization from the same screen.
API keys belong to an organization, not to a person: a key keeps working when the teammate who created it leaves.
Switch organizations
Use the organization switcher at the top of the dashboard sidebar. The dashboard then shows that organization's data; your other organizations are untouched.
Create more organizations
On a paid plan, open the switcher and choose Create organization. You become its owner and the dashboard switches to it right away.
- Who can: owners of at least one organization on a paid plan (Starter, Growth, Scale or an enterprise plan). Being an admin or member of someone else's paid organization does not count. On the Free plan the item is locked and links to the plans.
- Billing stays separate: the new organization starts on the Free plan, in sandbox, with its own quota. Upgrade it on its own if it needs to send more; its usage is never added to another organization's bill.
- Limit: up to 20 owned organizations per login. Contact support if you need more.
The dashboard uses POST /me/organizations (session only, not API keys). It answers 403 paid_plan_required without a paid organization you own, 403 organization_limit at the limit and 403 email_not_verified until your e-mail address is confirmed.