---
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`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/employees/{employee_id}/associated_persons`
- Auth: HTTP bearer

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

## Path parameters

- `employee_id` string, required

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

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-08-07** `7b8b3ed87c96`: 1 info
  - added the new optional `header` request parameter `X-Platform-Id`

[Operation history](https://skmtc.dev/kota/apis/kota-api/changes/employees/:employee_id/associated_persons/post.md)

---

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