---
title: "Create a new Billing Plan definition"
method: POST
path: "/v1/billing_plans/create"
tags: ["BillingPlanDefinitions"]
---

# Create a new Billing Plan definition

`POST /v1/billing_plans/create`

Create a new Billing Plan definition

## Response `201`

Successful operation

- BillingPlanDefinition
  - `sysId` string — Identifier of the definition
  - `createdOn` string, date-time — Definition created on
  - `updatedOn` string, date-time — Definition updated on
  - `headVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `releaseVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `owner` string — Owner of the billing plan
  - `name` string — Name of the billing plan
  - `description` string — Description of the billing plan
  - `is_active` boolean — States if the billing plan is active or not
  - `is_template` boolean — States if the plan is a template or not
  - `notes` string — Notes for the billing plan
  - `attachment_ids` string[] — List of attachment IDs
  - `raw_list_cost_adjusted_billing_plan` boolean — States if the billing plan is for raw list cost adjusted billing plan or not
  - `created_by` string — Created by
  - `updated_by` string — Updated by

## Other responses

- `400` — Invalid input
- `401` — Unauthorized
- `500` — Internal server error

---

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