---
title: "Create a product rate plan definition"
method: POST
path: "/v1/product-rateplan-definitions"
tags: ["Product Rate Plan Definitions"]
---

# Create a product rate plan definition

`POST /v1/product-rateplan-definitions`

Creates a product rate plan definition to use a charge in a product rate plan.

In the request, you must specify either the unique ID or number of both the charge and the product rate plan to add the specified charge to a specific rate plan.

**Note**: This operation requires the [Attribute-based Pricing](https://docs.zuora.com?resourceId=billing-attribute-based-pricing) feature to be enabled, which is in the **Early Adopter** phase.

## Headers

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

## Request body

- POSTRatePlanDefinitionRequest
  - `productRatePlanChargeId` string — The unique ID of the product rate plan charge to be used in the product rate plan.
  - `productRatePlanChargeNumber` string — The unique number (natural key) of the product rate plan charge to be used in the product rate plan.
  - `productRatePlanId` string — The unique ID of the product rate plan that uses this rate plan definition.
  - `productRatePlanNumber` string — The unique number (natural key) of the product rate plan that uses this rate plan definition.

## Response `200`

OK

- POSTRatePlanDefinitionResponse
  - `id` string — The unique ID of the product charge definition.
  - `success` boolean — Indicates whether the request succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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