---
title: "POST /create-custom-line-item"
method: POST
path: "/create-custom-line-item"
---

# POST /create-custom-line-item

`POST /create-custom-line-item`

Creates a custom line item that can be used to create a one-time fixed charge that can be applied to a single billing group for the current or previous billing period. The one-time fixed charge is either a fee or discount.

## Headers

- `X-Amzn-Client-Token` string

## Request body

- object
  - `Name` string, password, required — The name of the custom line item.
  - `Description` string, password, required — The description of the custom line item. This is shown on the Bills page in association with the charge value.
  - `BillingGroupArn` string, required — The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
  - `BillingPeriodRange` object — The billing period range in which the custom line item request will be applied.
    - `InclusiveStartBillingPeriod` string — The inclusive start billing period that defines a billing period range where a custom line is applied.
    - `ExclusiveEndBillingPeriod` string — The inclusive end billing period that defines a billing period range where a custom line is applied.
  - `Tags` object — A map that contains tag keys and tag values that are attached to a custom line item.
  - `ChargeDetails` object, required — The charge details of a custom line item. It should contain only one of <code>Flat</code> or <code>Percentage</code>.
    - `Flat` object — A <code>CustomLineItemFlatChargeDetails</code> that describes the charge details of a flat custom line item.
      - `ChargeValue` number, double, required — The custom line item's fixed charge value in USD.
    - `Percentage` object — A <code>CustomLineItemPercentageChargeDetails</code> that describes the charge details of a percentage custom line item.
      - `PercentageValue` number, double, required — The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
      - `AssociatedValues` CustomLineItemAssociationElement[] — A list of resource ARNs to associate to the percentage custom line item.
    - `Type` 'CREDIT' | 'FEE' — The type of the custom line item that indicates whether the charge is a fee or credit.
    - `LineItemFilters` LineItemFilter[] — A representation of the line item filter.
      - `Attribute` 'LINE_ITEM_TYPE' | 'SERVICE', required — The attribute of the line item filter. This specifies what attribute that you can filter on.
      - `MatchOption` 'NOT_EQUAL' | 'EQUAL', required — The match criteria of the line item filter. This parameter specifies whether not to include the resource value from the billing group total cost.
      - `Values` LineItemFilterValue[] — The values of the line item filter. This specifies the values to filter on. Currently, you can only exclude Savings Plans discounts.
      - `AttributeValues` AttributeValue[] — The values of the line item filter. This specifies the values to filter on.
  - `AccountId` string — The Amazon Web Services account in which this custom line item will be applied to.
  - `ComputationRule` 'ITEMIZED' | 'CONSOLIDATED' — The display settings of the custom line item
  - `PresentationDetails` object — An object that defines how custom line item charges are presented in the bill, containing specifications for service presentation.
    - `Service` string — The service under which the custom line item charges will be presented. Must be a string between 1 and 128 characters matching the pattern "<code>^[a-zA-Z0-9]+$</code>".

## Response `200`

Success

- CreateCustomLineItemOutput
  - `Arn` string — The Amazon Resource Name (ARN) of the created custom line item.

## 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)