---
title: "CRUD: Create a usage record"
method: POST
path: "/v1/object/usage"
tags: ["Usage"]
---

# CRUD: Create a usage record

`POST /v1/object/usage`

Creates a usage record.

## Query parameters

- `rejectUnknownFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `X-Zuora-WSDL-Version` string
- `Zuora-Version` string

## Request body

- ProxyCreateUsage — Container for custom fields of a Usage object.
  - `AccountId` string — The ID of the account associated with the usage data. This field is only required if no value is specified for the `AccountNumber` field. **Character limit**: 32 **Values**: a valid account ID.
  - `AccountNumber` string — The number of the account associated with the usage data. This field is only required if no value is specified for the `AccountId` field. **Character limit**: 50 **Values**: a valid account number.
  - `ChargeId` string — The OrginalId of the rate plan charge related to the usage record, e.g., `2c9081a03c63c94c013c6873357a0117` **Character limit**: 32 **Values**: a valid rate plan charge OriginalID.
  - `ChargeNumber` string — A unique number for the rate plan charge related to the usage record. For example, C-00000007.
  - `Description` string — A description of the usage record.
  - `EndDateTime` string, date-time — The end date and time of a range of time when usage is tracked. Use this field for reporting; this field doesn't affect usage calculation. **Character limit**: 29 **Values**: a valid date and time value.
  - `ProductRatePlanChargeNumber` string — Specify a product rate plan charge number so that you can charge your customer with a dynamic usage charge for the corresponding uploaded usage record. To use this field, you must set the `X-Zuora-WSDL-Version` request header to `146` or higher. Otherwise, an error occurs. **Note**: This field is only available if you have the <a href="https://docs.zuora.com/en/zuora-billing/bill-your-customer/usage-billing/dynamic-usage-charges" target="_blank">Dynamic Usage Charges</a> feature enabled.
  - `Quantity` number, double, required — Indicates the number of units used. **Character limit**: 16 **Values**: A valid decimal amount.
  - `StartDateTime` string, date-time, required — The start date and time of a range of time when usage is tracked. Zuora uses this field value to determine the usage date. Unlike the `EndDateTime`, the `StartDateTime` field does affect usage calculation. **Character limit**: 29 **Values**: a valid date and time value
  - `SubscriptionId` string — The original ID of the subscription that contains the fees related to the usage data. The ID of a subscription might change when you create amendments to the subscription. It is good practice to use the unique subscription number that you can specify in the `SubscriptionNumber` field.
  - `SubscriptionNumber` string — The unique identifier number of the subscription that contains the fees related to the usage data. It is good practice to use this field when creating usage records.
  - `UOM` string, required — Specifies the units to measure usage. Units of measure are configured in the web-based UI. Your values depend on your configuration in **Billing Settings**. **Character limit**: **Values**: a valid unit of measure
  - `UniqueKey` string — The unique external reference of the usage record. See [Upload usage record with unique key](https://docs.zuora.com?resourceId=billing-unbilled-usage) for information on how to use this field. **Note**: This field is only available if you set the `X-Zuora-WSDL-Version` request header to `114` or later. This field is only available if you have the <a href="https://docs.zuora.com?resourceId=billing-prepaid-with-drawdown-overview" target="_blank">Prepaid with Drawdown</a> feature or the <a href="https://docs.zuora.com?resourceId=billing-unbilled-usage" target="_blank">Unbilled Usage</a> feature enabled. See [Upload usage record with unique key](https://docs.zuora.com?resourceId=billing-unbilled-usage) for more information.

## Response `200`

OK

- ProxyCreateOrModifyResponse
  - `Id` string
  - `Success` boolean

## Other responses

- `400` — OK
- `401` — OK

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)