---
title: "POST /#X-Amz-Target=AWSBilling.CreateBillingView"
method: POST
path: "/#X-Amz-Target=AWSBilling.CreateBillingView"
---

# POST /#X-Amz-Target=AWSBilling.CreateBillingView

`POST /#X-Amz-Target=AWSBilling.CreateBillingView`

Creates a billing view with the specified billing view attributes.

## Headers

- `X-Amz-Target` 'AWSBilling.CreateBillingView', required

## Request body

- CreateBillingViewRequest
  - `name` string, password, required — The name of the billing view.
  - `description` string, password — The description of the billing view.
  - `sourceViews` BillingViewArn[], required — A list of billing views used as the data source for the custom billing view.
  - `dataFilterExpression` object — See <a href="https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_billing_Expression.html">Expression</a>. Billing view only supports <code>LINKED_ACCOUNT</code>, <code>Tags</code>, and <code>CostCategories</code>.
    - `dimensions` object — The specific <code>Dimension</code> to use for <code>Expression</code>.
      - `key` 'LINKED_ACCOUNT', required — The names of the metadata types that you can use to filter and group your results.
      - `values` Value[], required — The metadata values that you can use to filter and group your results.
    - `tags` object — The specific <code>Tag</code> to use for <code>Expression</code>.
      - `key` string, required — The key for the tag.
      - `values` Value[], required — The specific value of the tag.
    - `costCategories` object — The filter that's based on <code>CostCategory</code> values.
      - `key` string, required — The unique name of the Cost Category.
      - `values` Value[], required — The specific value of the Cost Category.
    - `timeRange` object — Specifies a time range filter for the billing view data.
      - `beginDateInclusive` string, date-time — The inclusive start date of the time range.
      - `endDateInclusive` string, date-time — The inclusive end date of the time range.
  - `clientToken` string — A unique, case-sensitive identifier you specify to ensure idempotency of the request. Idempotency ensures that an API request completes no more than one time. If the original request completes successfully, any subsequent retries complete successfully without performing any further actions with an idempotent request.
  - `resourceTags` ResourceTag[] — A list of key value map specifying tags associated to the billing view being created.
    - `key` string, required — The key that's associated with the tag.
    - `value` string — The value that's associated with the tag.

## Response `200`

Success

- CreateBillingViewResponse
  - `arn` string, required — The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
  - `createdAt` string, date-time — The time when the billing view was created.

## Other responses

- `480` — BillingViewHealthStatusException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ResourceNotFoundException
- `484` — AccessDeniedException
- `485` — ConflictException
- `486` — ValidationException
- `487` — InternalServerException

---

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