# Teams and organizations

Source: https://docs.rocketverifier.com/teams

> An organization groups teammates under one account with five roles (owner, admin, member, billing and viewer). With credit pooling on, members' verifications are paid from a shared balance, and organization API keys act for the team with their own rate limit and IP allowlist. Create the organization and invite people from the Team page in the dashboard.

An organization lets a team share one RocketVerifier setup: members with clear permissions, one credit pool, shared API keys and single sign-on.

## Create an organization

Open **Team** in the [dashboard](https://app.rocketverifier.com/dashboard/team) and create an organization with its name. You become its owner. Then invite your teammates from the **Members** tab.

**Step 1. Invite members**

Enter a teammate's email and pick a role. They get an invitation link that is valid for 7 days. Owners and admins can see pending invitations and cancel them.

**Step 2. Set up shared credits**

Ask our team to turn on credit pooling and fund the pool, so members' verifications draw from one balance. See [pooled credits](#pooled-credits).

**Step 3. Secure sign-in**

Owners and admins can connect a SAML identity provider in the **SSO** tab and require SSO for every member. See [single sign-on](#single-sign-on).

## Roles

Each member has exactly one role. Invitations can grant any role except owner; ownership is transferred, never shared.

| Role | Can do |
| --- | --- |
| `owner` | Everything: organization settings, deleting the organization, members, billing, API keys, audit log |
| `admin` | Manage and remove members, manage API keys, change settings, view the audit log |
| `member` | Verify, view API keys and create their own |
| `billing` | View and manage billing |
| `viewer` | View API keys and the audit log |

To transfer ownership, the owner changes another member's role to owner. The previous owner becomes an admin. The owner cannot leave or be removed until ownership has moved.

## Pooled credits

With credit pooling on, every charge for a member's verification is taken from the organization's shared pool when the pool covers the full amount. That includes requests made with the member's personal API keys.

- **Pool first.** A charge goes to the pool whenever it holds at least the full amount. A bulk job is charged in one go.
- **Never split.** If the pool cannot cover the whole charge, the member's personal balance pays instead.
- **Refunds follow the charge.** Unknown results, failed jobs and cancelled jobs refund the balance that paid.
- **Traceable.** Charges paid by the pool appear in the credit history with an `[Org pool]` prefix, and the **Credits** tab shows usage by member.

Credits bought on the Buy credits page go to your personal balance. Credit pooling and pool top-ups are arranged with our team: email support@rocketverifier.com.

### Balance checks on personal keys

A personal API key checks the member's own balance before work starts: `POST /v1/verify` needs at least 1 personal credit, and a bulk job needs as many personal credits as it has unique addresses, even when the pool will pay. Organization API keys check the larger of the pool and the owner's balance, so they are the right choice for shared services that should run on the pool.

## Organization API keys

An organization API key belongs to the team rather than a person. It:

- Acts as, and is billed to, the organization's owner, so charges draw from the pool first when pooling is on.
- Uses one rate limit bucket for the whole organization, separate from members' personal keys. The organization's limit applies, or the owner's plan limit when none is set.
- Accepts requests only from the organization's IP allowlist when one is set, and returns `403 ip_not_allowed` otherwise.
- Uses result version `2025-01-01` unless the request sends `RocketVerifier-Version: 2026-11-01`. See [result versions](https://docs.rocketverifier.com/versioning).

Organization keys and organization IP allowlists are issued by our team. Email support@rocketverifier.com with the organization and the scopes the key needs.

## Single sign-on

Organizations can sign members in through a SAML identity provider. In the **SSO** tab, owners and admins:

1. Verify the email domain with a DNS TXT record.
2. Enter the identity provider's metadata URL, or its SSO URL, entity ID and signing certificate.
3. Run a test sign-in, then enable SSO, and optionally require it for all members.

The tab shows the ACS URL, entity ID and metadata URL to paste into your identity provider.

## Audit log

Owners, admins and viewers can read the organization's audit log in the **Audit** tab. It records member changes (invitations, role changes, removals) and organization settings changes, with who made each change and when.

## Apps connected to an organization

When a member who is an owner or admin connects a third-party app through [RocketVerifier Connect](https://docs.rocketverifier.com/oauth), they can connect it to the organization instead of their personal account. The app then acts as the organization: billed to the pool, limited by the organization's rate limit and IP allowlist. If that member later loses the owner or admin role, the connection stops working with `401 invalid_token`.

## Next steps

- [Authentication](https://docs.rocketverifier.com/authentication)
Keys, scopes, expiry, IP allowlists and monthly spend caps.
- [Rate limits](https://docs.rocketverifier.com/rate-limits)
How organization requests are counted.

## Frequently asked questions

### Are credits I buy added to the organization pool?

No. Purchases on the Buy credits page go to your personal balance. The organization pool is set up and funded with our team; email support@rocketverifier.com.

### What happens when the pool cannot cover a charge?

The whole charge goes to the member's personal balance instead. A charge is never split between the pool and a personal balance, and refunds go back to whichever balance paid.

### How long does an invitation last?

Seven days. Owners and admins can cancel a pending invitation from the Members tab and send a new one.

### Can I delete my account while I own an organization?

Only when you are its last member. If the organization has other members, transfer ownership or remove them first.
