Create Employee Dependent

post

https://{companyDomain}.bamboohr.com/api/v1/employeedependents

Creates a new dependent record for an employee. employeeId is required and must reference a valid employee. relationship must be a valid relationship type and gender must be a valid gender value. isUsCitizen and isStudent accept "yes" or "no". state accepts a state code (e.g. "UT") and country accepts an ISO 3166-1 alpha-2 country code (e.g. "US"). dateOfBirth must be in YYYY-MM-DD format. SSN and SIN are accepted as plain text and stored encrypted. Accepts both application/json and application/xml request bodies. The response format mirrors the request Content-Type (not the Accept header): JSON request bodies receive a JSON response; XML request bodies receive an XML response. A successful creation fires an internal dependent-created event that may trigger downstream benefit enrollment processing.

Body Params

employeeId

string

required

The ID of the employee this dependent belongs to. Required.

firstName

string

The dependent's first name.

middleName

string

The dependent's middle name.

lastName

string

The dependent's last name.

relationship

string

The dependent's relationship to the employee (e.g. "spouse", "child", "domestic_partner").

gender

string

The dependent's gender.

ssn

string

The dependent's Social Security Number, provided as plain text. Stored encrypted. Returned as a masked value (e.g. "xxx-xx-1234") on read.

sin

string

The dependent's Social Insurance Number (Canadian equivalent of SSN), provided as plain text. Stored encrypted. Returned as a masked value on read.

dateOfBirth

date

The dependent's date of birth in YYYY-MM-DD format.

addressLine1

string

The first line of the dependent's address.

addressLine2

string

The second line of the dependent's address.

city

string

The dependent's city.

state

string

The dependent's state, provided as a state code (e.g. "UT"). Returned as a full state name on read.

zipCode

string

The dependent's ZIP or postal code.

homePhone

string

The dependent's home phone number.

country

string

The dependent's country, provided as an ISO 3166-1 alpha-2 country code (e.g. "US"). Returned as a full country name on read.

isUsCitizen

string

enum

Whether the dependent is a US citizen. Accepted values: "yes" or "no".

Allowed:

isStudent

string

enum

Whether the dependent is currently a student. Accepted values: "yes" or "no".

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

The request body is invalid or contains a validation error (e.g. missing employeeId, invalid relationship, gender, state code, country code, or date format).

403

The authenticated user does not have permission to add a dependent.

409

A duplicate record conflict was detected.

500

An unexpected server error occurred.

200The newly created dependent record. Format matches the request Content-Type (JSON or XML).