## Billing Groups

Billing groups allow Enterprise admins to understand and manage spend across groups of users. This functionality is useful for reporting, internal chargebacks, and budgeting.

## Billing group architecture

Admins can assign each member to a billing group. Members can only be in one billing group at a time. Members not actively assigned in any other billing group are placed in a reserved `Unassigned` group.

All usage is attributed to the user's group at the time it occurs. Historical data does not change when users move between groups, though it can be reassigned only when a group is deleted. In that case, all of its usage is moved to the Unassigned group.

## View billing groups

Enterprise admins can view billing groups in the web dashboard under the `Members & Groups` tab. This table shows each group, how it is configured, the number of members in it, and spend for the period.

## Create and add members to a billing group

Admins can create billing groups by clicking `Create Group`. After naming the group, there are four ways to assign members to that group:

1. **SCIM**: Sync the billing group with an existing [SCIM group](/content/docs/account/teams/scim#scim/index.html).
2. **API**: Create groups and add members programmatically via the [Admin API](/content/docs/account/teams/admin-api#billing-groups/index.html).
3. **CSV**: Upload a CSV with group names and email addresses of members.
4. **Manual**: Click `Add Members` and manually select `Unassigned` members to be added.

Billing groups synced with SCIM cannot be edited via CSV, API, or manual UI changes. All member assignment for SCIM-synced groups must be handled via SCIM.

## Move members between billing groups

Admins can move members from manual billing groups by clicking on the billing group and selecting `Move`.

- **SCIM**: When members are moved between SCIM groups in your identity provider, the billing group follows those changes automatically.
- **API**: Use the [add members](/content/docs/account/teams/admin-api#add-members-to-group/index.html) and [remove members](/content/docs/account/teams/admin-api#remove-members-from-group/index.html) endpoints to move members programmatically.

## Rename a billing group

Billing groups can be renamed by clicking the gear button on the main menu, or by clicking `Rename` on the page for that specific billing group.

- **API**: Use the [update group](/content/docs/account/teams/admin-api#update-group/index.html) endpoint to rename groups programmatically.

## Delete a billing group

Billing groups can be deleted by clicking the gear button on the main menu, or by clicking `Delete` on the page for that specific billing group.

- **API**: Use the [delete group](/content/docs/account/teams/admin-api#delete-group/index.html) endpoint to delete groups programmatically.

Deleting a billing group is a destructive operation; data cannot be recovered. All historic usage for deleted groups is assigned retroactively to the `Unassigned` group.

Billing groups are available on the Enterprise plan.

Contact our team to learn about spend management and reporting.