> ## 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 worker beneficiary

> Add a beneficiary to a worker.

### Parameters

<ParamField body="worker" type="string" required>
  ID of the worker this beneficiary belongs to.
</ParamField>

<ParamField body="name" type="object" required>
  The beneficiary's name.
</ParamField>

<ParamField body="type" type="string">
  Beneficiary type. One of `individual`, `trust`, `estate`, or `organization`.
  Defaults to `individual`.
</ParamField>

<ParamField body="relationship" type="string">
  Relationship to the worker. One of `spouse`, `child`, `domestic_partner`,
  `step_child`, `adopted_child`, `foster_child`, `grandchild`, `civil_union`,
  `legal_guardianship`, `ex_spouse`, or `other`.
</ParamField>

<ParamField body="dob" type="string">
  Date of birth for an individual beneficiary.
</ParamField>

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

### Returns

Returns the created [Worker beneficiary object](/reference/worker-beneficiaries/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "worker": "wrkr_8oWZpQ2rL4sk",
    "name": { "first": "Amara", "last": "Okafor" },
    "dob": "1990-04-12",
    "relationship": "spouse"
  }
  ```

  ```json Response theme={null}
  {
    "id": "wben_8oWZpQ2rL4sk",
    "object": "worker_beneficiary",
    "worker": "wrkr_8oWZpQ2rL4sk",
    "type": "individual",
    "name": { "first": "Amara", "last": "Okafor", "full": "Amara Okafor" },
    "relationship": "spouse",
    "dob": "1990-04-12",
    "status": "active",
    "created": "2026-05-29T12:00:00Z",
    "updated": "2026-05-29T12:00:00Z"
  }
  ```
</ResponseExample>