Organizations

Create organizations, manage members and roles, and require two-factor authentication.

An Organization groups your team's Applications, members, and billing. Your Unipile user account can belong to several organizations, with a different role in each.

Create or switch organizations

  1. Open the user and organization menu at the bottom of the Dashboard sidebar.
  2. Select Switch organization.
  3. Choose an organization, or choose the create action and enter its name.

The organization creator becomes an Owner. Open an application in that organization to access its Members, Billing & Usage, and settings.

Free trial eligibility

Creating or joining an organization uses your eligibility for future free trials. A later organization you create may therefore require a subscription before you can use the API. See Billing for the eligibility rules and account limits.

Roles and permissions

Organization roles apply across its applications. Development and Production have different resource-management permissions; there is no separate per-application membership list.

ActionMemberAdminOwner
View application resourcesYesYesYes
Link accounts and add webhook endpointsYesYesYes
Remove accounts; modify or delete webhooks; change Hosted Auth, OAuth, rate limits, or domain activationDevelopment onlyYesYes
Edit account metadata or available automatic proxy settingsYesYesYes
Rename the selected applicationYesYesYes
Manage global and scoped Account API KeysDevelopment onlyYesYes
Manage Service API KeysNoYesYes
Manage ScopesDevelopment onlyYesYes
Create or delete applicationsNoYesYes
Invite membersNoYesYes
Manage another member's role or remove themNoNon-Owners onlyYes
Open organization settings and Billing & UsageNoNoYes

Members have read-only access to API Keys and Scopes in Production applications. Only Admins and Owners can create or revoke Service API Keys, including in Development.

An organization must retain at least one Owner. The Members screen does not offer actions to change your own role; ask another authorized member to manage it when needed.

Invite and manage members

Invite a teammate

  1. Open an application in the target organization and choose Members.
  2. Click Invite member.
  3. Enter the teammate's email address and choose Member, Admin, or Owner.
  4. Send the invitation.

The member appears as Pending until they accept. An existing member or pending invitation cannot be added a second time. An organization supports up to 50 members, including pending invitations.

Join an organization

Open the link in your invitation email, then sign in or register with that same email address. Accept the invitation to join the organization.

If the organization requires 2FA, configure it before accepting. If an invitation is invalid or has expired, ask an Admin or Owner to send it again.

Resend or cancel an invitation

On Members, open the pending member's actions menu:

  • Choose Resend invite to send another invitation email.
  • Choose Remove and confirm to cancel the pending membership.

Change a role or remove a member

Open another member's actions menu and choose Update role or Remove. Review the change and confirm it. Role changes are available after the invitation has been accepted.

Admins can manage non-Owners; Owners can manage other members, including Owners. The last Owner cannot be removed or demoted. To hand over responsibility, make another accepted member an Owner before having your own membership changed.

The 2FA column shows whether each registered member has enabled two-factor authentication. Check enrollment here before making it mandatory.

Leave an organization

Open Members, choose Leave organization, and confirm. You lose access to that organization's applications.

The Dashboard disables this action if you are an Owner or the only member. If you are an Owner, arrange for another Owner to change your role or remove your membership while preserving at least one Owner.

Rename the organization

As an Owner, open the user and organization menu, choose Settings, update the organization name, and save.

Enforce two-factor authentication

An Owner can require all members to enable 2FA:

  1. Enable 2FA on your own user account.
  2. Open the user and organization menu and choose Settings.
  3. In Security, enable Enforce Two-factor authentication and confirm.

Members without 2FA are directed to configure it when signing in. The requirement also applies when accepting an invitation. Members cannot disable their personal 2FA while belonging to an organization that enforces it.

To remove the requirement, return to the same setting, switch it off, and confirm. Removing the organization policy does not turn off 2FA on members' user accounts.

Delete an organization

An Owner can open Settings → Danger zone, choose the organization deletion action, and confirm. Deletion removes the organization's applications and their associated resources, including connected accounts. It cannot be undone.

You cannot delete an organization while it has a current subscription. Cancel the subscription through Billing & Usage, wait until the current subscription period has ended, then retry.


Did this page help you?