---
title: "POST /usage-based-items/{usage_based_item_id}/tiers"
method: POST
path: "/usage-based-items/{usage_based_item_id}/tiers"
tags: ["usageBasedItemTiers"]
---

# POST /usage-based-items/{usage_based_item_id}/tiers

`POST /usage-based-items/{usage_based_item_id}/tiers`

Create new usage based item (Ex. mileage, generator, delivery)

## Path parameters

- `usage_based_item_id` integer, required

## Request body

- UsageBasedItemTier
  - `created` string
  - `id` integer
  - `maximum` number, double
  - `minimum_fee` integer
  - `owner_id` integer
  - `price` number, double
  - `tax_amount` integer
  - `total` integer
  - `updated` string
  - `usage_based_item_id` integer

## Response `200`

- UsageBasedItem
  - `archived` boolean
  - `created` string
  - `fee_type` string
  - `formatted` UsageFormatted
    - `included_text` string
    - `overage_fee_calculation` OverageFeeCalculation
      - `calculation_tiers` UsageTierFormatted[]
        - `cost` string
        - `label` string
        - `per_unit` string
        - `usage_price_per_unit` string
      - `formatted_included_usage` string
      - `formatted_total_amount` string
      - `total_amount` integer
      - `total_days` integer
      - `total_free_used` number, double
      - `total_included` number, double
      - `total_over_free` number, double
      - `total_used` number, double
    - `short_unit` string
    - `tiers` UsageTierFormatted[]
      - `cost` string
      - `label` string
      - `per_unit` string
      - `usage_price_per_unit` string
  - `id` integer
  - `included` number, double
  - `included_period` string
  - `name` string
  - `owner_id` integer
  - `single_tier` boolean
  - `tax_amount` integer
  - `tax_rate_id` integer — deprecated
  - `tax_rate_ids` integer[] — tax rate support
  - `tiers` UsageBasedItemTier[]
    - `created` string
    - `id` integer
    - `maximum` number, double
    - `minimum_fee` integer
    - `owner_id` integer
    - `price` number, double
    - `tax_amount` integer
    - `total` integer
    - `updated` string
    - `usage_based_item_id` integer
  - `total_included` number, double
  - `unit` string
  - `unlimited` boolean
  - `updated` string

## Other responses

- `400` — Invalid input or state means you're bad
- `401` — Unauthorized error
- `default` — An unknown, unexpected error.

---

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