---
title: "Create an associated person"
method: POST
path: "/employees/{employee_id}/associated_persons"
tags: ["Associated Persons"]
---

# Create an associated person

`POST /employees/{employee_id}/associated_persons`

Creates an associated person (dependent or beneficiary) linked to an employee.

## Path parameters

- `employee_id` string, required

## Headers

- `X-Platform-Id` string

## Request body

- CreateAssociatedPersonRequest
  - `first_name` string, required — Must not be empty. NOTE: This field will be normalized according to our internal formatting rules.
  - `last_name` string, required — Must not be empty. NOTE: This field will be normalized according to our internal formatting rules.
  - `date_of_birth` string, date, required — Must be in the past, but after 1900-01-01
  - `sex_at_birth` 'male' | 'female', required
  - `relationship_type` 'spouse' | 'partner' | 'child' | 'other', required
  - `email` string, nullable — NOTE: This field will be normalized according to our internal formatting rules.
  - `phone_number` string, nullable — Phone number in E.164 international format (e.g. +447700900999). NOTE: This field will be normalized according to our internal formatting rules.

## Response `200`

OK

- AssociatedPersonResponse
  - `id` string, required — Unique identifier for the associated person
  - `platform_id` string — Unique identifier for the platform
  - `employee_id` string, required — Unique identifier for the employee this person is associated with
  - `first_name` string, required — First name of the associated person
  - `last_name` string, required — Last name of the associated person
  - `date_of_birth` string, date, required — Date of birth of the associated person
  - `sex_at_birth` 'male' | 'female', required
  - `relationship_type` 'spouse' | 'partner' | 'child' | 'other', required
  - `email` string, nullable — Email address of the associated person
  - `phone_number` string, nullable — Phone number in E.164 international format (e.g. +447700900999)
  - `object` string — The object type

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/revisions/85bb8b3c42b4/schema)