Add new dependent

members.dependents.create(member_id, **kwargs) -> Dependent { id, active, created_at, 10 more }

post/v1/members/{member_id}/dependents

Creates a new dependent record for a member. Required: first name, last name, date of birth, sex, and relationship type. SSN is optional but recommended for coverage verification.

ParametersExpand Collapse

member_id: String

date_of_birth: Date

Date of birth (YYYY-MM-DD)

formatdate

first_name: String

Dependent's legal first name

maxLength100

minLength1

last_name: String

Dependent's legal last name

maxLength100

minLength1

relationship: Relationship

Spouse - Spouse
Child - Child

Accepts one of the following:

:Spouse

:Child

sex: Sex

Male - Male
Female - Female
Other - Other
Unknown - Unknown

Accepts one of the following:

:Male

:Female

:Other

:Unknown

gender: String

Gender identity

ssn: String

Social Security Number (optional, XXX-XX-XXXX or XXXXXXXXX)

maxLength11

minLength9

suffix: String

Name suffix (Jr., Sr., III)

maxLength10

ReturnsExpand Collapse

class Dependent { id, active, created_at, 10 more }

Serializer for Dependent entity in public API responses.

Dependents are family members (spouse, children) who may be eligible for benefit coverage through an employee.

id: String

Unique dependent identifier with 'dpnd_' prefix

active: bool

Whether the dependent is currently active

created_at: Time

Timestamp when the dependent was created

formatdate-time

date_of_birth: Date

Dependent's date of birth (YYYY-MM-DD)

formatdate

first_name: String

Dependent's legal first name

last_name: String

Dependent's legal last name

member_id: String

ID of the primary member/employee (mbr_*)

relationship: Relationship

Spouse - Spouse
Child - Child

Accepts one of the following:

:Spouse

:Child

sex: Sex

Male - Male
Female - Female
Other - Other
Unknown - Unknown

Accepts one of the following:

:Male

:Female

:Other

:Unknown

updated_at: Time

Timestamp when the dependent was last updated

formatdate-time

gender: String

Gender identity, if provided

ssn_last_four: String

Last 4 digits of SSN (masked)

suffix: String

Name suffix (e.g., Jr., Sr., III)

Add new dependent

require "vitable_connect_api"

vitable_connect_api = VitableConnectAPI::Client.new(
  api_key: "My API Key",
  environment: "environment_1" # defaults to "production"
)

dependent = vitable_connect_api.members.dependents.create(
  "mbr_abc123def456",
  date_of_birth: "2019-12-27",
  first_name: "x",
  last_name: "x",
  relationship: :Spouse,
  sex: :Male
)

puts(dependent)

{
  "id": "id",
  "active": true,
  "created_at": "2019-12-27T18:11:19.117Z",
  "date_of_birth": "2019-12-27",
  "first_name": "first_name",
  "last_name": "last_name",
  "member_id": "member_id",
  "relationship": "Spouse",
  "sex": "Male",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "gender": "gender",
  "ssn_last_four": "ssn_last_four",
  "suffix": "suffix"
}

Returns Examples

{
  "id": "id",
  "active": true,
  "created_at": "2019-12-27T18:11:19.117Z",
  "date_of_birth": "2019-12-27",
  "first_name": "first_name",
  "last_name": "last_name",
  "member_id": "member_id",
  "relationship": "Spouse",
  "sex": "Male",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "gender": "gender",
  "ssn_last_four": "ssn_last_four",
  "suffix": "suffix"
}