API ReferenceAssociated Persons

Create an associated person

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

Authentication

AuthorizationBearer
Authorization header using the Bearer scheme

Path Parameters

employee_idstringRequiredformat: "ee_.+"

Request

This endpoint expects an object.
first_namestringRequired

Must not be empty. NOTE: This field will be normalized according to our internal formatting rules.

last_namestringRequired

Must not be empty. NOTE: This field will be normalized according to our internal formatting rules.

date_of_birthdateRequired

Must be in the past, but after 1900-01-01

sex_at_birthenumRequired
The sex assigned to the associated person at birth
Allowed values:
relationship_typeenumRequired
The relationship type between the employee and the associated person
Allowed values:
emailstring or nullOptional

NOTE: This field will be normalized according to our internal formatting rules.

phone_numberstring or nullOptional

Phone number in E.164 international format (e.g. +447700900999). NOTE: This field will be normalized according to our internal formatting rules.

Response

OK
idstringformat: "ap_.+"
Unique identifier for the associated person
employee_idstringformat: "ee_.+"
Unique identifier for the employee this person is associated with
first_namestring
First name of the associated person
last_namestring
Last name of the associated person
date_of_birthdate
Date of birth of the associated person
sex_at_birthenum
The sex assigned to the associated person at birth
Allowed values:
relationship_typeenum
The relationship type between the employee and the associated person
Allowed values:
emailstring or null
Email address of the associated person
phone_numberstring or null

Phone number in E.164 international format (e.g. +447700900999)

objectstring or null
The object type

Errors