---
title: "Create a new plan"
method: POST
path: "/plans"
tags: ["Plan"]
---

# Create a new plan

`POST /plans`

Creates a new plan with the provided details

## Headers

- `tenant-id` string, required

## Request body

- CreatePlanRequest
  - `data` PlanSchema — Represents a healthcare plan with business line, network type, and benefits information.
    - `lineOfBusiness` 'Medicare' | 'Medicaid' | 'Commercial' — Specifies the line of business associated with a healthcare plan.
    - `networkType` 'Commercial - HMO' | 'Commercial - PPO' | 'Medicare - HMO' | 'Medicaid - HMO' — Specifies the line of business and network type combination for a healthcare plan.
    - `benefits` string — The benefits offered under the plan.
    - `name` string — The name of the plan.

## Response `201`

Plan created successfully

- PlanResponse
  - `id` string
  - `tenantId` string
  - `payerId` string
  - `data` JsonNode
    - `empty` boolean
    - `valueNode` boolean
    - `containerNode` boolean
    - `missingNode` boolean
    - `array` boolean
    - `object` boolean
    - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
    - `pojo` boolean
    - `number` boolean
    - `integralNumber` boolean
    - `floatingPointNumber` boolean
    - `short` boolean
    - `int` boolean
    - `long` boolean
    - `float` boolean
    - `double` boolean
    - `bigDecimal` boolean
    - `bigInteger` boolean
    - `textual` boolean
    - `boolean` boolean
    - `null` boolean
    - `binary` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/3d27e9019c7b/schema)