---
title: "Add a person"
method: POST
path: "/cases/{case_id}/persons"
tags: ["Persons"]
---

# Add a person

`POST /cases/{case_id}/persons`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/persons`
- Auth: none declared

Add an interested person or beneficiary to a case.

## Request body

- PersonWrite
  - `first_name` string, required
  - `middle_name` string
  - `last_name` string, required
  - `suffix` string
  - `relationship` string
  - `email` string, email
  - `phone` string
  - `is_beneficiary` boolean
  - `possible_dispute` boolean
  - `is_deceased` boolean
  - `waiver_status` 'no_waiver_needed' | 'waiver_pending' | 'waiver_signed' | 'waiver_refused'

## Response `201`

Person added.

- object
  - `data` Person
    - `id` string
    - `first_name` string
    - `middle_name` string, nullable
    - `last_name` string
    - `suffix` string, nullable
    - `relationship` string
    - `email` string, email, nullable
    - `phone` string, nullable
    - `is_beneficiary` boolean
    - `possible_dispute` boolean
    - `is_deceased` boolean
    - `waiver_status` 'no_waiver_needed' | 'waiver_pending' | 'waiver_signed' | 'waiver_refused'
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404`: Resource not found.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)