> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a benefit plan

> Add a plan to a benefits program.

### Parameters

<ParamField body="program" type="string" required>
  ID of the program the plan belongs to.
</ParamField>

<ParamField body="provider" type="string" required>
  ID of the carrier (benefit provider).
</ParamField>

<ParamField body="name" type="string" required>
  Human-readable plan name.
</ParamField>

<ParamField body="type" type="string" required>
  Benefit category. One of `medical`, `dental`, `vision`, `life`, `disability`,
  `retirement`, or `other`.
</ParamField>

<ParamField body="coverages" type="array">
  Coverage tiers the plan offers, e.g. `["employee_only", "family"]`.
</ParamField>

<ParamField body="country" type="string | null">
  ISO-3166 country the plan is offered in. Omit for a global plan.
</ParamField>

<ParamField body="network" type="string | null">
  Network name or type (e.g. `ppo`, `hmo`).
</ParamField>

<ParamField body="status" type="string">
  Plan status. One of `draft`, `active`, or `inactive`. Defaults to `draft`.
</ParamField>

<ParamField body="starts" type="date | null">
  First day the plan is in effect.
</ParamField>

<ParamField body="ends" type="date | null">
  Last day the plan is in effect.
</ParamField>

<ParamField body="eligibility" type="string | null">
  CEL expression deciding which workers may elect this plan, evaluated against
  the worker shape. Omit to offer it to anyone eligible for the program.
</ParamField>

<ParamField body="contribution" type="object">
  Employer cost-sharing policy, by coverage tier.
</ParamField>

<ParamField body="terms" type="object">
  Display summary of plan terms.
</ParamField>

<ParamField body="resources" type="object">
  Plan materials — links and document references.
</ParamField>

<ParamField body="metadata" type="object">
  Set of key-value pairs attached to the plan.
</ParamField>

### Returns

Returns the created [Benefit plan object](/reference/benefit-plans/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "program": "bprog_R8mK2pQ9xL4s",
    "provider": "benpr_8oWZpQ2rL4sk",
    "name": "UnitedHealthcare PPO — Gold",
    "type": "medical",
    "coverages": ["employee_only", "family"]
  }
  ```

  ```json Response theme={null}
  {
    "id": "benpl_V6nP3qR9tY2m",
    "object": "benefit.plan",
    "program": "bprog_R8mK2pQ9xL4s",
    "provider": "benpr_8oWZpQ2rL4sk",
    "entity": "ent_8oWZpQ2rL4sk",
    "name": "UnitedHealthcare PPO — Gold",
    "type": "medical",
    "country": null,
    "network": null,
    "status": "draft",
    "coverages": ["employee_only", "family"],
    "eligibility": null,
    "contribution": {},
    "terms": {},
    "resources": {},
    "starts": null,
    "ends": null,
    "metadata": {},
    "created": "2026-05-29T12:00:00Z",
    "updated": "2026-05-29T12:00:00Z"
  }
  ```
</ResponseExample>