---
title: "POST /billing-groups/{billingGroupName}"
method: POST
path: "/billing-groups/{billingGroupName}"
---

# POST /billing-groups/{billingGroupName}

`POST /billing-groups/{billingGroupName}`

Creates a billing group.

Requires permission to access the [CreateBillingGroup](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `billingGroupName` string, required

## Request body

- object
  - `billingGroupProperties` object — The properties of a billing group.
    - `billingGroupDescription` string — The description of the billing group.
  - `tags` Tag[] — Metadata which can be used to manage the billing group.
    - `Key` string, required — The tag's key.
    - `Value` string — The tag's value.

## Response `200`

Success

- CreateBillingGroupResponse
  - `billingGroupName` string — The name you gave to the billing group.
  - `billingGroupArn` string — The ARN of the billing group.
  - `billingGroupId` string — The ID of the billing group.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceAlreadyExistsException
- `482` — ThrottlingException
- `483` — InternalFailureException

---

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