> ## 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 event

> Open an enrollment window.

Open an enrollment window against a program. Provide an `entity` for an
entity-wide open enrollment, or a `worker` for a new-hire or QLE event — exactly
one is required.

### Parameters

<ParamField body="program" type="string" required>
  ID of the [program](/reference/benefit-programs/object) the window opens into.
</ParamField>

<ParamField body="type" type="string" required>
  What opens the window. One of `open_enrollment`, `new_hire`, `qle`, or
  `termination`.
</ParamField>

<ParamField body="date" type="string" required>
  The event point — the hire or QLE date, or the open-enrollment effective date.
</ParamField>

<ParamField body="entity" type="string">
  ID of the entity, for an entity-wide open enrollment. Required unless `worker`
  is set.
</ParamField>

<ParamField body="worker" type="string">
  ID of the worker, for a new-hire or QLE event. Required unless `entity` is set.
</ParamField>

<ParamField body="subtype" type="string">
  For a `qle`, the qualifying reason — e.g. `marriage`, `newborn`, `divorce`,
  `adoption`, `lost_coverage`.
</ParamField>

<ParamField body="starts" type="string">
  First day the enrollment window is open.
</ParamField>

<ParamField body="ends" type="string">
  Last day the enrollment window is open.
</ParamField>

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

### Returns

Returns the created [Benefit event object](/reference/benefit-events/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "program": "bprog_R8mK2pQ9xL4s",
    "entity": "ent_8oWZpQ2rL4sk",
    "type": "open_enrollment",
    "date": "2027-01-01",
    "starts": "2026-11-01",
    "ends": "2026-11-30"
  }
  ```

  ```json Response theme={null}
  {
    "id": "benev_K2mP9qR4xL7s",
    "object": "benefit.event",
    "program": "bprog_R8mK2pQ9xL4s",
    "entity": "ent_8oWZpQ2rL4sk",
    "worker": null,
    "type": "open_enrollment",
    "subtype": null,
    "date": "2027-01-01",
    "starts": "2026-11-01",
    "ends": "2026-11-30",
    "metadata": {},
    "created": "2026-05-29T12:00:00Z",
    "updated": "2026-05-29T12:00:00Z"
  }
  ```
</ResponseExample>