---
title: "POST /create-billing-group"
method: POST
path: "/create-billing-group"
---

# POST /create-billing-group

`POST /create-billing-group`

Creates a billing group that resembles a consolidated billing family that Amazon Web Services charges, based off of the predefined pricing plan computation.

## Headers

- `X-Amzn-Client-Token` string

## Request body

- object
  - `Name` string, password, required — The billing group name. The names must be unique.
  - `AccountGrouping` object, required — The set of accounts that will be under the billing group. The set of accounts resemble the linked accounts in a consolidated billing family.
    - `LinkedAccountIds` AccountId[] — The account IDs that make up the billing group. Account IDs must be a part of the consolidated billing family, and not associated with another billing group.
    - `AutoAssociate` boolean — Specifies if this billing group will automatically associate newly added Amazon Web Services accounts that join your consolidated billing family.
    - `ResponsibilityTransferArn` string — The Amazon Resource Name (ARN) that identifies the transfer relationship owned by the Bill Transfer account (caller account). When specified, the PrimaryAccountId is no longer required.
  - `ComputationPreference` object, required — The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
    - `PricingPlanArn` string — The Amazon Resource Name (ARN) of the pricing plan that's used to compute the Amazon Web Services charges for a billing group.
  - `PrimaryAccountId` string — The account ID that serves as the main account in a billing group.
  - `Description` string, password — The description of the billing group.
  - `Tags` object — A map that contains tag keys and tag values that are attached to a billing group. This feature isn't available during the beta.

## Response `200`

Success

- CreateBillingGroupOutput
  - `Arn` string — The Amazon Resource Name (ARN) of the created billing group.

## Other responses

- `480` — ConflictException
- `481` — ThrottlingException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — ServiceLimitExceededException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/billingconductor.md) · [All operations](https://skmtc.net/aws/apis/billingconductor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/billingconductor/versions/2cc5849dea95/schema)