@vitable-inc/vitable-connect 5.1.1 → 5.2.0

package/dist/cjs/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@vitable-inc/vitable-connect",
-        "X-Fern-SDK-Version": "5.1.1",
-        "User-Agent": "@vitable-inc/vitable-connect/5.1.1",
+        "X-Fern-SDK-Version": "5.2.0",
+        "User-Agent": "@vitable-inc/vitable-connect/5.2.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/members/client/Client.d.ts

@@ -61,6 +61,42 @@ export declare class MembersClient {
      */
     listDependents(request: VitableConnect.ListDependentsMembersRequest, requestOptions?: MembersClient.RequestOptions): core.HttpResponsePromise<VitableConnect.MemberDependentsResponse>;
     private __listDependents;
+    /**
+     * Saves a dependent (spouse or child) for a member. Saving does not enroll the dependent or change the member's coverage or coverage tier. If the member already has an active dependent matching this person, that relationship is reused and returned with a 200 and `created: false`; otherwise a new one is created with a 201 and `created: true`. In both cases the dependent's address is set to the one supplied; other details of a person Vitable already has on file are not changed. When a new dependent is created at exactly the member's address, Vitable also adds them to the member's household where it can; this never fails the request. The returned IDs identify the saved dependent. Social Security numbers are not accepted, and a body with an `ssn` field returns a 400. The caller must have write access to the target member, and API access tokens cannot save dependents. A member not visible to the caller returns a 404 before the body is validated. Business-rule failures return a 422 with `child_over_max_age` (a child must be under 26), `duplicate_active_spouse` (the member already has a different active spouse), `same_member`, `member_creation_failed`, or `legal_dependent_creation_failed`.
+     *
+     * @param {VitableConnect.CreateMemberDependentRequest} request
+     * @param {MembersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link VitableConnect.BadRequestError}
+     * @throws {@link VitableConnect.UnauthorizedError}
+     * @throws {@link VitableConnect.ForbiddenError}
+     * @throws {@link VitableConnect.NotFoundError}
+     * @throws {@link VitableConnect.ConflictError}
+     * @throws {@link VitableConnect.UnprocessableEntityError}
+     * @throws {@link VitableConnect.TooManyRequestsError}
+     * @throws {@link VitableConnect.InternalServerError}
+     * @throws {@link VitableConnect.BadGatewayError}
+     * @throws {@link errors.VitableConnectError}
+     * @throws {@link errors.VitableConnectTimeoutError}
+     *
+     * @example
+     *     await client.members.createDependent({
+     *         member_id: "mbr_abc123def456",
+     *         first_name: "Sam",
+     *         last_name: "Doe",
+     *         date_of_birth: "2015-06-01",
+     *         sex_at_birth: "Male",
+     *         relationship: "Child",
+     *         address: {
+     *             address_line_1: "123 Main St",
+     *             city: "Detroit",
+     *             state: "MI",
+     *             zipcode: "48201"
+     *         }
+     *     })
+     */
+    createDependent(request: VitableConnect.CreateMemberDependentRequest, requestOptions?: MembersClient.RequestOptions): core.HttpResponsePromise<VitableConnect.SavedMemberDependentResponse>;
+    private __createDependent;
     /**
      * Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404.
      *

package/dist/cjs/api/resources/members/client/Client.js

@@ -42,11 +42,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MembersClient = void 0;
 const BaseClient_js_1 = require("../../../../BaseClient.js");
 const headers_js_1 = require("../../../../core/headers.js");
 const core = __importStar(require("../../../../core/index.js"));
+const requestBody_js_1 = require("../../../../core/requestBody.js");
 const environments = __importStar(require("../../../../environments.js"));
 const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
 const errors = __importStar(require("../../../../errors/index.js"));
@@ -209,6 +221,100 @@ class MembersClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/members/{member_id}/dependents");
         });
     }
+    /**
+     * Saves a dependent (spouse or child) for a member. Saving does not enroll the dependent or change the member's coverage or coverage tier. If the member already has an active dependent matching this person, that relationship is reused and returned with a 200 and `created: false`; otherwise a new one is created with a 201 and `created: true`. In both cases the dependent's address is set to the one supplied; other details of a person Vitable already has on file are not changed. When a new dependent is created at exactly the member's address, Vitable also adds them to the member's household where it can; this never fails the request. The returned IDs identify the saved dependent. Social Security numbers are not accepted, and a body with an `ssn` field returns a 400. The caller must have write access to the target member, and API access tokens cannot save dependents. A member not visible to the caller returns a 404 before the body is validated. Business-rule failures return a 422 with `child_over_max_age` (a child must be under 26), `duplicate_active_spouse` (the member already has a different active spouse), `same_member`, `member_creation_failed`, or `legal_dependent_creation_failed`.
+     *
+     * @param {VitableConnect.CreateMemberDependentRequest} request
+     * @param {MembersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link VitableConnect.BadRequestError}
+     * @throws {@link VitableConnect.UnauthorizedError}
+     * @throws {@link VitableConnect.ForbiddenError}
+     * @throws {@link VitableConnect.NotFoundError}
+     * @throws {@link VitableConnect.ConflictError}
+     * @throws {@link VitableConnect.UnprocessableEntityError}
+     * @throws {@link VitableConnect.TooManyRequestsError}
+     * @throws {@link VitableConnect.InternalServerError}
+     * @throws {@link VitableConnect.BadGatewayError}
+     * @throws {@link errors.VitableConnectError}
+     * @throws {@link errors.VitableConnectTimeoutError}
+     *
+     * @example
+     *     await client.members.createDependent({
+     *         member_id: "mbr_abc123def456",
+     *         first_name: "Sam",
+     *         last_name: "Doe",
+     *         date_of_birth: "2015-06-01",
+     *         sex_at_birth: "Male",
+     *         relationship: "Child",
+     *         address: {
+     *             address_line_1: "123 Main St",
+     *             city: "Detroit",
+     *             state: "MI",
+     *             zipcode: "48201"
+     *         }
+     *     })
+     */
+    createDependent(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createDependent(request, requestOptions));
+    }
+    __createDependent(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request, _body = __rest(request, ["member_id", "X-Vitable-Organization"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/dependents`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: (0, requestBody_js_1.mergeAdditionalBodyParameters)(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new VitableConnect.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new VitableConnect.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new VitableConnect.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new VitableConnect.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new VitableConnect.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new VitableConnect.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new VitableConnect.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new VitableConnect.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new VitableConnect.BadGatewayError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.VitableConnectError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/members/{member_id}/dependents");
+        });
+    }
     /**
      * Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404.
      *

package/dist/cjs/api/resources/members/client/requests/CreateMemberDependentRequest.d.ts

@@ -0,0 +1,74 @@
+import type * as VitableConnect from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         member_id: "mbr_abc123def456",
+ *         first_name: "Sam",
+ *         last_name: "Doe",
+ *         date_of_birth: "2015-06-01",
+ *         sex_at_birth: "Male",
+ *         relationship: "Child",
+ *         address: {
+ *             address_line_1: "123 Main St",
+ *             city: "Detroit",
+ *             state: "MI",
+ *             zipcode: "48201"
+ *         }
+ *     }
+ */
+export interface CreateMemberDependentRequest {
+    /** Unique member identifier (mbr_*) */
+    member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
+    /** Dependent's legal first name */
+    first_name: string;
+    /** Dependent's legal last name */
+    last_name: string;
+    /**
+     * Name suffix
+     *
+     * * `Sr` - Sr
+     * * `Jr` - Jr
+     * * `I` - I
+     * * `II` - II
+     * * `III` - III
+     * * `IV` - IV
+     * * `V` - V
+     */
+    suffix?: VitableConnect.NameSuffix | null;
+    /** Date of birth (YYYY-MM-DD); cannot be in the future */
+    date_of_birth: string;
+    /**
+     * Sex assigned at birth
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Other` - Other
+     * * `Unknown` - Unknown
+     */
+    sex_at_birth?: VitableConnect.SexAtBirth | null;
+    /**
+     * Gender identity
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Transgender` - Transgender
+     * * `Non-binary` - Non-binary
+     * * `Prefer not to respond` - Prefer not to respond
+     */
+    gender?: VitableConnect.Gender | null;
+    /** Dependent's email address. Ignored for dependents under 18, and not changed for a dependent Vitable already has on file. */
+    email?: string | null;
+    /** Dependent's 10-digit US phone number; formatting characters and a leading 1 are ignored. Ignored for dependents under 18, and not changed for a dependent Vitable already has on file. */
+    phone?: string | null;
+    /**
+     * Relationship of the dependent to the member
+     *
+     * * `Spouse` - Spouse
+     * * `Child` - Child
+     */
+    relationship: VitableConnect.Relationship;
+    /** Dependent's residential address */
+    address: VitableConnect.CreateMemberDependentAddressRequest;
+}

package/dist/cjs/api/resources/members/client/requests/CreateMemberDependentRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/members/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export type { CreateMemberDependentRequest } from "./CreateMemberDependentRequest.js";
 export type { GetHouseholdMembersRequest } from "./GetHouseholdMembersRequest.js";
 export type { GetMembersRequest } from "./GetMembersRequest.js";
 export type { ListDependentsMembersRequest } from "./ListDependentsMembersRequest.js";

package/dist/cjs/api/types/CreateMemberDependentAddressRequest.d.ts

@@ -0,0 +1,78 @@
+import type * as VitableConnect from "../index.js";
+export interface CreateMemberDependentAddressRequest {
+    /** Primary street address */
+    address_line_1: string;
+    /** Secondary street address */
+    address_line_2?: (string | null) | undefined;
+    /** City name */
+    city: string;
+    /**
+     * Two-letter state code
+     *
+     * * `AL` - AL
+     * * `AK` - AK
+     * * `AZ` - AZ
+     * * `AR` - AR
+     * * `CA` - CA
+     * * `CO` - CO
+     * * `CT` - CT
+     * * `DC` - DC
+     * * `DE` - DE
+     * * `FL` - FL
+     * * `GA` - GA
+     * * `HI` - HI
+     * * `ID` - ID
+     * * `IL` - IL
+     * * `IN` - IN
+     * * `IA` - IA
+     * * `KS` - KS
+     * * `KY` - KY
+     * * `LA` - LA
+     * * `ME` - ME
+     * * `MD` - MD
+     * * `MA` - MA
+     * * `MI` - MI
+     * * `MN` - MN
+     * * `MS` - MS
+     * * `MO` - MO
+     * * `MT` - MT
+     * * `NE` - NE
+     * * `NV` - NV
+     * * `NH` - NH
+     * * `NJ` - NJ
+     * * `NM` - NM
+     * * `NY` - NY
+     * * `NC` - NC
+     * * `ND` - ND
+     * * `OH` - OH
+     * * `OK` - OK
+     * * `OR` - OR
+     * * `PA` - PA
+     * * `RI` - RI
+     * * `SC` - SC
+     * * `SD` - SD
+     * * `TN` - TN
+     * * `TX` - TX
+     * * `UT` - UT
+     * * `VT` - VT
+     * * `VA` - VA
+     * * `WA` - WA
+     * * `WI` - WI
+     * * `WV` - WV
+     * * `WY` - WY
+     * * `PR` - PR
+     * * `GU` - GU
+     * * `AS` - AS
+     * * `VI` - VI
+     * * `MP` - MP
+     * * `MH` - MH
+     * * `PW` - PW
+     * * `FM` - FM
+     * * `AE` - AE
+     * * `AA` - AA
+     * * `AP` - AP
+     */
+    state: VitableConnect.State;
+    /** ZIP code */
+    zipcode: string;
+}

package/dist/cjs/api/types/CreateMemberDependentAddressRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/Gender.d.ts

@@ -2,8 +2,8 @@
  * * `Male` - Male
  * * `Female` - Female
  * * `Transgender` - Transgender
- * * `Non-binary` - Non Binary
- * * `Prefer not to respond` - Prefer Not To Respond
+ * * `Non-binary` - Non-binary
+ * * `Prefer not to respond` - Prefer not to respond
  */
 export declare const Gender: {
     readonly Male: "Male";

package/dist/cjs/api/types/Gender.js

@@ -6,8 +6,8 @@ exports.Gender = void 0;
  * * `Male` - Male
  * * `Female` - Female
  * * `Transgender` - Transgender
- * * `Non-binary` - Non Binary
- * * `Prefer not to respond` - Prefer Not To Respond
+ * * `Non-binary` - Non-binary
+ * * `Prefer not to respond` - Prefer not to respond
  */
 exports.Gender = {
     Male: "Male",

package/dist/cjs/api/types/MemberEnrollment.d.ts

@@ -90,7 +90,7 @@ export interface MemberEnrollment {
      * * `Cancelled` - Cancelled
      */
     policy_status: VitableConnect.PlanYearEnrollmentPolicyStatus | null;
-    /** True when today falls in the final month of the plan-year coverage window; drives end-of-coverage enrollment actions on the client. */
+    /** True when today (ET) falls in the final month of the member's individual coverage (the earliest of termination, subscription end, plan-year end, and selected-plan end) or of the plan-year coverage window; drives end-of-coverage enrollment actions on the client. */
     in_last_month_of_coverage: boolean;
     /** True when today falls inside the enrollment window this member has to answer in; drives enrollment-action availability on the client. */
     is_within_enrollment_window: boolean;

package/dist/cjs/api/types/SavedMemberDependent.d.ts

@@ -0,0 +1,38 @@
+import type * as VitableConnect from "../index.js";
+/**
+ * Wire serializer for :class:`MemberLegalDependentDTO` (one legal-dependent row).
+ */
+export interface SavedMemberDependent {
+    /** The dependent's own member identifier with 'mbr_' prefix */
+    member_id?: string | undefined;
+    /** The primary member's identifier with 'mbr_' prefix */
+    primary_member_id?: string | undefined;
+    /** Dependent's first name */
+    first_name: string;
+    /** Dependent's last name */
+    last_name: string;
+    /**
+     * Relationship of the dependent to the member (e.g., Spouse, Child)
+     *
+     * * `Spouse` - Spouse
+     * * `Child` - Child
+     */
+    relationship: VitableConnect.Relationship;
+    /** Date of birth (YYYY-MM-DD) */
+    date_of_birth: string;
+    /** Dependent's age in years, derived from date of birth */
+    age: number;
+    /**
+     * Sex assigned at birth, if provided
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Other` - Other
+     * * `Unknown` - Unknown
+     */
+    sex_at_birth?: (VitableConnect.SexAtBirth | null) | undefined;
+    /** Identifier of the dependent relationship, with 'ldep_' prefix */
+    legal_dependent_id: string;
+    /** True when the relationship was created by this request, false when an existing one was reused */
+    created: boolean;
+}

package/dist/cjs/api/types/SavedMemberDependent.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SavedMemberDependentResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as VitableConnect from "../index.js";
+/**
+ * Response containing a single saved member dependent resource.
+ */
+export interface SavedMemberDependentResponse {
+    data: VitableConnect.SavedMemberDependent;
+}

package/dist/cjs/api/types/SavedMemberDependentResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -30,6 +30,7 @@ export * from "./ContributionTier.js";
 export * from "./CoverageTier.js";
 export * from "./CreatedAfter.js";
 export * from "./CreatedBefore.js";
+export * from "./CreateMemberDependentAddressRequest.js";
 export * from "./DeductionDetail.js";
 export * from "./DeductionFrequency.js";
 export * from "./DetailedAddress.js";
@@ -162,6 +163,8 @@ export * from "./RemainingEmployeeAction.js";
 export * from "./RequestId.js";
 export * from "./ResourceId.js";
 export * from "./ResourceType.js";
+export * from "./SavedMemberDependent.js";
+export * from "./SavedMemberDependentResponse.js";
 export * from "./Search.js";
 export * from "./SexAtBirth.js";
 export * from "./State.js";

package/dist/cjs/api/types/index.js

@@ -46,6 +46,7 @@ __exportStar(require("./ContributionTier.js"), exports);
 __exportStar(require("./CoverageTier.js"), exports);
 __exportStar(require("./CreatedAfter.js"), exports);
 __exportStar(require("./CreatedBefore.js"), exports);
+__exportStar(require("./CreateMemberDependentAddressRequest.js"), exports);
 __exportStar(require("./DeductionDetail.js"), exports);
 __exportStar(require("./DeductionFrequency.js"), exports);
 __exportStar(require("./DetailedAddress.js"), exports);
@@ -178,6 +179,8 @@ __exportStar(require("./RemainingEmployeeAction.js"), exports);
 __exportStar(require("./RequestId.js"), exports);
 __exportStar(require("./ResourceId.js"), exports);
 __exportStar(require("./ResourceType.js"), exports);
+__exportStar(require("./SavedMemberDependent.js"), exports);
+__exportStar(require("./SavedMemberDependentResponse.js"), exports);
 __exportStar(require("./Search.js"), exports);
 __exportStar(require("./SexAtBirth.js"), exports);
 __exportStar(require("./State.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.1";
+export declare const SDK_VERSION = "5.2.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "5.1.1";
+exports.SDK_VERSION = "5.2.0";

package/dist/esm/BaseClient.mjs

@@ -7,8 +7,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@vitable-inc/vitable-connect",
-        "X-Fern-SDK-Version": "5.1.1",
-        "User-Agent": "@vitable-inc/vitable-connect/5.1.1",
+        "X-Fern-SDK-Version": "5.2.0",
+        "User-Agent": "@vitable-inc/vitable-connect/5.2.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/members/client/Client.d.mts

@@ -61,6 +61,42 @@ export declare class MembersClient {
      */
     listDependents(request: VitableConnect.ListDependentsMembersRequest, requestOptions?: MembersClient.RequestOptions): core.HttpResponsePromise<VitableConnect.MemberDependentsResponse>;
     private __listDependents;
+    /**
+     * Saves a dependent (spouse or child) for a member. Saving does not enroll the dependent or change the member's coverage or coverage tier. If the member already has an active dependent matching this person, that relationship is reused and returned with a 200 and `created: false`; otherwise a new one is created with a 201 and `created: true`. In both cases the dependent's address is set to the one supplied; other details of a person Vitable already has on file are not changed. When a new dependent is created at exactly the member's address, Vitable also adds them to the member's household where it can; this never fails the request. The returned IDs identify the saved dependent. Social Security numbers are not accepted, and a body with an `ssn` field returns a 400. The caller must have write access to the target member, and API access tokens cannot save dependents. A member not visible to the caller returns a 404 before the body is validated. Business-rule failures return a 422 with `child_over_max_age` (a child must be under 26), `duplicate_active_spouse` (the member already has a different active spouse), `same_member`, `member_creation_failed`, or `legal_dependent_creation_failed`.
+     *
+     * @param {VitableConnect.CreateMemberDependentRequest} request
+     * @param {MembersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link VitableConnect.BadRequestError}
+     * @throws {@link VitableConnect.UnauthorizedError}
+     * @throws {@link VitableConnect.ForbiddenError}
+     * @throws {@link VitableConnect.NotFoundError}
+     * @throws {@link VitableConnect.ConflictError}
+     * @throws {@link VitableConnect.UnprocessableEntityError}
+     * @throws {@link VitableConnect.TooManyRequestsError}
+     * @throws {@link VitableConnect.InternalServerError}
+     * @throws {@link VitableConnect.BadGatewayError}
+     * @throws {@link errors.VitableConnectError}
+     * @throws {@link errors.VitableConnectTimeoutError}
+     *
+     * @example
+     *     await client.members.createDependent({
+     *         member_id: "mbr_abc123def456",
+     *         first_name: "Sam",
+     *         last_name: "Doe",
+     *         date_of_birth: "2015-06-01",
+     *         sex_at_birth: "Male",
+     *         relationship: "Child",
+     *         address: {
+     *             address_line_1: "123 Main St",
+     *             city: "Detroit",
+     *             state: "MI",
+     *             zipcode: "48201"
+     *         }
+     *     })
+     */
+    createDependent(request: VitableConnect.CreateMemberDependentRequest, requestOptions?: MembersClient.RequestOptions): core.HttpResponsePromise<VitableConnect.SavedMemberDependentResponse>;
+    private __createDependent;
     /**
      * Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404.
      *

package/dist/esm/api/resources/members/client/Client.mjs

@@ -8,9 +8,21 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
 import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
+import { mergeAdditionalBodyParameters } from "../../../../core/requestBody.mjs";
 import * as environments from "../../../../environments.mjs";
 import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
 import * as errors from "../../../../errors/index.mjs";
@@ -173,6 +185,100 @@ export class MembersClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/members/{member_id}/dependents");
         });
     }
+    /**
+     * Saves a dependent (spouse or child) for a member. Saving does not enroll the dependent or change the member's coverage or coverage tier. If the member already has an active dependent matching this person, that relationship is reused and returned with a 200 and `created: false`; otherwise a new one is created with a 201 and `created: true`. In both cases the dependent's address is set to the one supplied; other details of a person Vitable already has on file are not changed. When a new dependent is created at exactly the member's address, Vitable also adds them to the member's household where it can; this never fails the request. The returned IDs identify the saved dependent. Social Security numbers are not accepted, and a body with an `ssn` field returns a 400. The caller must have write access to the target member, and API access tokens cannot save dependents. A member not visible to the caller returns a 404 before the body is validated. Business-rule failures return a 422 with `child_over_max_age` (a child must be under 26), `duplicate_active_spouse` (the member already has a different active spouse), `same_member`, `member_creation_failed`, or `legal_dependent_creation_failed`.
+     *
+     * @param {VitableConnect.CreateMemberDependentRequest} request
+     * @param {MembersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link VitableConnect.BadRequestError}
+     * @throws {@link VitableConnect.UnauthorizedError}
+     * @throws {@link VitableConnect.ForbiddenError}
+     * @throws {@link VitableConnect.NotFoundError}
+     * @throws {@link VitableConnect.ConflictError}
+     * @throws {@link VitableConnect.UnprocessableEntityError}
+     * @throws {@link VitableConnect.TooManyRequestsError}
+     * @throws {@link VitableConnect.InternalServerError}
+     * @throws {@link VitableConnect.BadGatewayError}
+     * @throws {@link errors.VitableConnectError}
+     * @throws {@link errors.VitableConnectTimeoutError}
+     *
+     * @example
+     *     await client.members.createDependent({
+     *         member_id: "mbr_abc123def456",
+     *         first_name: "Sam",
+     *         last_name: "Doe",
+     *         date_of_birth: "2015-06-01",
+     *         sex_at_birth: "Male",
+     *         relationship: "Child",
+     *         address: {
+     *             address_line_1: "123 Main St",
+     *             city: "Detroit",
+     *             state: "MI",
+     *             zipcode: "48201"
+     *         }
+     *     })
+     */
+    createDependent(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createDependent(request, requestOptions));
+    }
+    __createDependent(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request, _body = __rest(request, ["member_id", "X-Vitable-Organization"]);
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/dependents`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(_body, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new VitableConnect.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new VitableConnect.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new VitableConnect.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new VitableConnect.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new VitableConnect.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new VitableConnect.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new VitableConnect.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new VitableConnect.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new VitableConnect.BadGatewayError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.VitableConnectError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/members/{member_id}/dependents");
+        });
+    }
     /**
      * Lists a member's employment across every employer — the same employee record shape as the employer's employees list, plus the employer name. For an organization caller the rows are scoped to companies in that organization's book; a member (self/household) or Vitable Admin sees all employments. A member not visible to the caller returns a 404.
      *

package/dist/esm/api/resources/members/client/requests/CreateMemberDependentRequest.d.mts

@@ -0,0 +1,74 @@
+import type * as VitableConnect from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         member_id: "mbr_abc123def456",
+ *         first_name: "Sam",
+ *         last_name: "Doe",
+ *         date_of_birth: "2015-06-01",
+ *         sex_at_birth: "Male",
+ *         relationship: "Child",
+ *         address: {
+ *             address_line_1: "123 Main St",
+ *             city: "Detroit",
+ *             state: "MI",
+ *             zipcode: "48201"
+ *         }
+ *     }
+ */
+export interface CreateMemberDependentRequest {
+    /** Unique member identifier (mbr_*) */
+    member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
+    /** Dependent's legal first name */
+    first_name: string;
+    /** Dependent's legal last name */
+    last_name: string;
+    /**
+     * Name suffix
+     *
+     * * `Sr` - Sr
+     * * `Jr` - Jr
+     * * `I` - I
+     * * `II` - II
+     * * `III` - III
+     * * `IV` - IV
+     * * `V` - V
+     */
+    suffix?: VitableConnect.NameSuffix | null;
+    /** Date of birth (YYYY-MM-DD); cannot be in the future */
+    date_of_birth: string;
+    /**
+     * Sex assigned at birth
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Other` - Other
+     * * `Unknown` - Unknown
+     */
+    sex_at_birth?: VitableConnect.SexAtBirth | null;
+    /**
+     * Gender identity
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Transgender` - Transgender
+     * * `Non-binary` - Non-binary
+     * * `Prefer not to respond` - Prefer not to respond
+     */
+    gender?: VitableConnect.Gender | null;
+    /** Dependent's email address. Ignored for dependents under 18, and not changed for a dependent Vitable already has on file. */
+    email?: string | null;
+    /** Dependent's 10-digit US phone number; formatting characters and a leading 1 are ignored. Ignored for dependents under 18, and not changed for a dependent Vitable already has on file. */
+    phone?: string | null;
+    /**
+     * Relationship of the dependent to the member
+     *
+     * * `Spouse` - Spouse
+     * * `Child` - Child
+     */
+    relationship: VitableConnect.Relationship;
+    /** Dependent's residential address */
+    address: VitableConnect.CreateMemberDependentAddressRequest;
+}

package/dist/esm/api/resources/members/client/requests/CreateMemberDependentRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/members/client/requests/index.d.mts

@@ -1,3 +1,4 @@
+export type { CreateMemberDependentRequest } from "./CreateMemberDependentRequest.mjs";
 export type { GetHouseholdMembersRequest } from "./GetHouseholdMembersRequest.mjs";
 export type { GetMembersRequest } from "./GetMembersRequest.mjs";
 export type { ListDependentsMembersRequest } from "./ListDependentsMembersRequest.mjs";

package/dist/esm/api/types/CreateMemberDependentAddressRequest.d.mts

@@ -0,0 +1,78 @@
+import type * as VitableConnect from "../index.mjs";
+export interface CreateMemberDependentAddressRequest {
+    /** Primary street address */
+    address_line_1: string;
+    /** Secondary street address */
+    address_line_2?: (string | null) | undefined;
+    /** City name */
+    city: string;
+    /**
+     * Two-letter state code
+     *
+     * * `AL` - AL
+     * * `AK` - AK
+     * * `AZ` - AZ
+     * * `AR` - AR
+     * * `CA` - CA
+     * * `CO` - CO
+     * * `CT` - CT
+     * * `DC` - DC
+     * * `DE` - DE
+     * * `FL` - FL
+     * * `GA` - GA
+     * * `HI` - HI
+     * * `ID` - ID
+     * * `IL` - IL
+     * * `IN` - IN
+     * * `IA` - IA
+     * * `KS` - KS
+     * * `KY` - KY
+     * * `LA` - LA
+     * * `ME` - ME
+     * * `MD` - MD
+     * * `MA` - MA
+     * * `MI` - MI
+     * * `MN` - MN
+     * * `MS` - MS
+     * * `MO` - MO
+     * * `MT` - MT
+     * * `NE` - NE
+     * * `NV` - NV
+     * * `NH` - NH
+     * * `NJ` - NJ
+     * * `NM` - NM
+     * * `NY` - NY
+     * * `NC` - NC
+     * * `ND` - ND
+     * * `OH` - OH
+     * * `OK` - OK
+     * * `OR` - OR
+     * * `PA` - PA
+     * * `RI` - RI
+     * * `SC` - SC
+     * * `SD` - SD
+     * * `TN` - TN
+     * * `TX` - TX
+     * * `UT` - UT
+     * * `VT` - VT
+     * * `VA` - VA
+     * * `WA` - WA
+     * * `WI` - WI
+     * * `WV` - WV
+     * * `WY` - WY
+     * * `PR` - PR
+     * * `GU` - GU
+     * * `AS` - AS
+     * * `VI` - VI
+     * * `MP` - MP
+     * * `MH` - MH
+     * * `PW` - PW
+     * * `FM` - FM
+     * * `AE` - AE
+     * * `AA` - AA
+     * * `AP` - AP
+     */
+    state: VitableConnect.State;
+    /** ZIP code */
+    zipcode: string;
+}

package/dist/esm/api/types/CreateMemberDependentAddressRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Gender.d.mts

@@ -2,8 +2,8 @@
  * * `Male` - Male
  * * `Female` - Female
  * * `Transgender` - Transgender
- * * `Non-binary` - Non Binary
- * * `Prefer not to respond` - Prefer Not To Respond
+ * * `Non-binary` - Non-binary
+ * * `Prefer not to respond` - Prefer not to respond
  */
 export declare const Gender: {
     readonly Male: "Male";

package/dist/esm/api/types/Gender.mjs

@@ -3,8 +3,8 @@
  * * `Male` - Male
  * * `Female` - Female
  * * `Transgender` - Transgender
- * * `Non-binary` - Non Binary
- * * `Prefer not to respond` - Prefer Not To Respond
+ * * `Non-binary` - Non-binary
+ * * `Prefer not to respond` - Prefer not to respond
  */
 export const Gender = {
     Male: "Male",

package/dist/esm/api/types/MemberEnrollment.d.mts

@@ -90,7 +90,7 @@ export interface MemberEnrollment {
      * * `Cancelled` - Cancelled
      */
     policy_status: VitableConnect.PlanYearEnrollmentPolicyStatus | null;
-    /** True when today falls in the final month of the plan-year coverage window; drives end-of-coverage enrollment actions on the client. */
+    /** True when today (ET) falls in the final month of the member's individual coverage (the earliest of termination, subscription end, plan-year end, and selected-plan end) or of the plan-year coverage window; drives end-of-coverage enrollment actions on the client. */
     in_last_month_of_coverage: boolean;
     /** True when today falls inside the enrollment window this member has to answer in; drives enrollment-action availability on the client. */
     is_within_enrollment_window: boolean;

package/dist/esm/api/types/SavedMemberDependent.d.mts

@@ -0,0 +1,38 @@
+import type * as VitableConnect from "../index.mjs";
+/**
+ * Wire serializer for :class:`MemberLegalDependentDTO` (one legal-dependent row).
+ */
+export interface SavedMemberDependent {
+    /** The dependent's own member identifier with 'mbr_' prefix */
+    member_id?: string | undefined;
+    /** The primary member's identifier with 'mbr_' prefix */
+    primary_member_id?: string | undefined;
+    /** Dependent's first name */
+    first_name: string;
+    /** Dependent's last name */
+    last_name: string;
+    /**
+     * Relationship of the dependent to the member (e.g., Spouse, Child)
+     *
+     * * `Spouse` - Spouse
+     * * `Child` - Child
+     */
+    relationship: VitableConnect.Relationship;
+    /** Date of birth (YYYY-MM-DD) */
+    date_of_birth: string;
+    /** Dependent's age in years, derived from date of birth */
+    age: number;
+    /**
+     * Sex assigned at birth, if provided
+     *
+     * * `Male` - Male
+     * * `Female` - Female
+     * * `Other` - Other
+     * * `Unknown` - Unknown
+     */
+    sex_at_birth?: (VitableConnect.SexAtBirth | null) | undefined;
+    /** Identifier of the dependent relationship, with 'ldep_' prefix */
+    legal_dependent_id: string;
+    /** True when the relationship was created by this request, false when an existing one was reused */
+    created: boolean;
+}

package/dist/esm/api/types/SavedMemberDependent.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SavedMemberDependentResponse.d.mts

@@ -0,0 +1,7 @@
+import type * as VitableConnect from "../index.mjs";
+/**
+ * Response containing a single saved member dependent resource.
+ */
+export interface SavedMemberDependentResponse {
+    data: VitableConnect.SavedMemberDependent;
+}

package/dist/esm/api/types/SavedMemberDependentResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -30,6 +30,7 @@ export * from "./ContributionTier.mjs";
 export * from "./CoverageTier.mjs";
 export * from "./CreatedAfter.mjs";
 export * from "./CreatedBefore.mjs";
+export * from "./CreateMemberDependentAddressRequest.mjs";
 export * from "./DeductionDetail.mjs";
 export * from "./DeductionFrequency.mjs";
 export * from "./DetailedAddress.mjs";
@@ -162,6 +163,8 @@ export * from "./RemainingEmployeeAction.mjs";
 export * from "./RequestId.mjs";
 export * from "./ResourceId.mjs";
 export * from "./ResourceType.mjs";
+export * from "./SavedMemberDependent.mjs";
+export * from "./SavedMemberDependentResponse.mjs";
 export * from "./Search.mjs";
 export * from "./SexAtBirth.mjs";
 export * from "./State.mjs";

package/dist/esm/api/types/index.mjs

@@ -30,6 +30,7 @@ export * from "./ContributionTier.mjs";
 export * from "./CoverageTier.mjs";
 export * from "./CreatedAfter.mjs";
 export * from "./CreatedBefore.mjs";
+export * from "./CreateMemberDependentAddressRequest.mjs";
 export * from "./DeductionDetail.mjs";
 export * from "./DeductionFrequency.mjs";
 export * from "./DetailedAddress.mjs";
@@ -162,6 +163,8 @@ export * from "./RemainingEmployeeAction.mjs";
 export * from "./RequestId.mjs";
 export * from "./ResourceId.mjs";
 export * from "./ResourceType.mjs";
+export * from "./SavedMemberDependent.mjs";
+export * from "./SavedMemberDependentResponse.mjs";
 export * from "./Search.mjs";
 export * from "./SexAtBirth.mjs";
 export * from "./State.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.1";
+export declare const SDK_VERSION = "5.2.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.1";
+export const SDK_VERSION = "5.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitable-inc/vitable-connect",
-    "version": "5.1.1",
+    "version": "5.2.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -2185,6 +2185,82 @@ await client.members.listDependents({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.members.<a href="/src/api/resources/members/client/Client.ts">createDependent</a>({ ...params }) -> VitableConnect.SavedMemberDependentResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Saves a dependent (spouse or child) for a member. Saving does not enroll the dependent or change the member's coverage or coverage tier. If the member already has an active dependent matching this person, that relationship is reused and returned with a 200 and `created: false`; otherwise a new one is created with a 201 and `created: true`. In both cases the dependent's address is set to the one supplied; other details of a person Vitable already has on file are not changed. When a new dependent is created at exactly the member's address, Vitable also adds them to the member's household where it can; this never fails the request. The returned IDs identify the saved dependent. Social Security numbers are not accepted, and a body with an `ssn` field returns a 400. The caller must have write access to the target member, and API access tokens cannot save dependents. A member not visible to the caller returns a 404 before the body is validated. Business-rule failures return a 422 with `child_over_max_age` (a child must be under 26), `duplicate_active_spouse` (the member already has a different active spouse), `same_member`, `member_creation_failed`, or `legal_dependent_creation_failed`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.members.createDependent({
+    member_id: "mbr_abc123def456",
+    first_name: "Sam",
+    last_name: "Doe",
+    date_of_birth: "2015-06-01",
+    sex_at_birth: "Male",
+    relationship: "Child",
+    address: {
+        address_line_1: "123 Main St",
+        city: "Detroit",
+        state: "MI",
+        zipcode: "48201"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `VitableConnect.CreateMemberDependentRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MembersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>