---
title: "Add dependents to a dependents management intent"
method: POST
path: "/dependents_management_intents/{dependents_management_intent_id}/dependents"
tags: ["Dependents Management Intents"]
---

# Add dependents to a dependents management intent

`POST /dependents_management_intents/{dependents_management_intent_id}/dependents`

Adds one or more existing associated persons as dependents to a dependents management intent.

## Path parameters

- `dependents_management_intent_id` string, required

## Headers

- `Idempotency-Key` string
- `X-Platform-Id` string

## Request body

- AddDependentsRequest
  - `associated_person_ids` string[], required — List of associated person IDs to add as dependents. Must not be empty.
  - `dependent_coverage_selections` DependentCoverageSelectionsRequest[], nullable — Optional coverage selections per dependent. Keyed by associated person ID.
    - `associated_person_id` string, required — The associated person ID this selection applies to.
    - `coverage_selections` PlanCoverageOptionSelectionRequest[], required — Coverage option selections for member-scoped configurations.
      - `configuration_id` string, required — Configuration ID (prefixed with `pc_`).
      - `options` SelectedOptionRequest[], required — Selected options with optional sub-options.
        - `option_id` string, required — Option ID (prefixed with `pco_`).
        - `sub_options` SelectedOptionRequest[], nullable — Sub-option selections, if applicable.

## Response `200`

OK

- DependentsManagementIntentResponse
  - `id` string, required — Unique identifier for the dependents management intent. Prefixed with `dmi_`.
  - `object` string — Object type identifier.
  - `parent_intent_id` string, required — The parent intent ID (e.g. Policy Amendment Intent ID). Prefixed based on type.
  - `parent_intent_type` 'policy_amendment_intent' | 'enrolment_intent', required
  - `status` 'action_required' | 'processing' | 'completed' | 'not_undertaken', required
  - `dependents` DependentInfoResponse[], required — List of dependents being managed.
    - `associated_person_id` string, required — The associated person ID. Prefixed with `ap_`.
    - `status` 'pending_confirmation' | 'action_required' | 'ineligible' | 'processing' | 'restricted' | 'ready', required
    - `coverage_selections` PlanCoverageOptionSelectionResponse[], nullable — Coverage option selections for this dependent. Populated when member-scoped selections have been provided.
      - `configuration_id` string, required — Configuration ID (prefixed with `pc_`).
      - `options` SelectedOptionResponse[], required — Selected options.
        - `option_id` string, required — Option ID (prefixed with `pco_`).
        - `sub_options` SelectedOptionResponse[], nullable — Selected sub-options, if applicable.
    - `requirement_id` string, nullable — The adaptive requirement ID for this dependent. Populated when the dependent has an open adaptive requirement (status is `action_required`). Prefixed with `ar_`.
  - `plan` PlanWithPricingResponse, required
    - `id` string, required — Unique identifier for the plan. Prefixed with `pl_`.
    - `name` string, required — The name of the plan.
    - `description` string, required — Description of the plan.
    - `pricing` PlanPricingResponse, required
      - `type` 'per_member' | 'tier_based', required
      - `per_member` PerMemberPricingResponse
        - `currency` 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'xof' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnd' | 'bob' | 'bov' | 'brl' | 'bsd' | 'inr' | 'btn' | 'nok' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'xaf' | 'cdf' | 'chf' | 'che' | 'chw' | 'nzd' | 'clp' | 'clf' | 'cny' | 'cop' | 'cou' | 'crc' | 'cup' | 'cuc' | 'cve' | 'ang' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'ern' | 'etb' | 'fjd' | 'fkp' | 'mdl' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'idr' | 'xdr' | 'ils' | 'iqd' | 'irr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'kpw' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'zar' | 'lyd' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sdg' | 'sek' | 'sgd' | 'shp' | 'sll' | 'sos' | 'srd' | 'ssp' | 'stn' | 'svc' | 'xsu' | 'syp' | 'twd' | 'szl' | 'thb' | 'tjs' | 'tmt' | 'tnd' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'ugx' | 'usn' | 'uyu' | 'uyi' | 'uyw' | 'uzs' | 'ves' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'xua' | 'zmw' | 'zwl', required
        - `member_type_pricing` MemberTypePricingResponse[], required — Pricing for each member type.
          - `code` 'adult' | 'young_adult' | 'child', required
          - `display_name` string, required — Display name for the member type.
          - `monthly_premium` number, double, required — Monthly premium amount.
      - `tier_based` TierBasedPricingResponse
        - `currency` 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'xof' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnd' | 'bob' | 'bov' | 'brl' | 'bsd' | 'inr' | 'btn' | 'nok' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'xaf' | 'cdf' | 'chf' | 'che' | 'chw' | 'nzd' | 'clp' | 'clf' | 'cny' | 'cop' | 'cou' | 'crc' | 'cup' | 'cuc' | 'cve' | 'ang' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'ern' | 'etb' | 'fjd' | 'fkp' | 'mdl' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'idr' | 'xdr' | 'ils' | 'iqd' | 'irr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'kpw' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'zar' | 'lyd' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sdg' | 'sek' | 'sgd' | 'shp' | 'sll' | 'sos' | 'srd' | 'ssp' | 'stn' | 'svc' | 'xsu' | 'syp' | 'twd' | 'szl' | 'thb' | 'tjs' | 'tmt' | 'tnd' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'ugx' | 'usn' | 'uyu' | 'uyi' | 'uyw' | 'uzs' | 'ves' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'xua' | 'zmw' | 'zwl', required
        - `tiers` PricingTierResponse[], required — Pricing tiers for different family compositions.
          - `code` 'single' | 'couple' | 'single_parent' | 'family', required
          - `display_name` string, required — Display name for the tier.
          - `monthly_premium` number, double, required — Monthly premium amount for this tier.
          - `annual_premium` number, double, required — Annual premium amount for this tier.
          - `display_dependent_requirements` string, required — Description of dependent requirements for this tier.
  - `coverage_options` PlanCoverageResponse[], nullable — Available member-scoped coverage options for the plan. Present when the plan has member-scoped coverage configurations.
    - `id` string, required — Unique identifier for the coverage selection. Prefixed with `pc_`.
    - `name` string, required — Title for this coverage selection. Typically used as the display heading.
    - `description` string, nullable — Full description of this coverage selection.
    - `scope` 'group_policy' | 'policy' | 'member', required
    - `input_type` 'single_select' | 'multi_select', required
    - `required` boolean, required — Whether a selection is mandatory.
    - `min_selections` integer, nullable — Minimum required selections (multi-select only).
    - `max_selections` integer, nullable — Maximum allowed selections (multi-select only).
    - `sort_order` integer, nullable — Display ordering hint.
    - `group_label` string, nullable — Optional grouping label for UI rendering. Indicates which coverage selections are best presented together from a UX standpoint.
    - `options` PlanCoverageOptionResponse[], required — Available options within this coverage selection.
      - `id` string, required — Unique identifier for this coverage option. Prefixed with `pco_`.
      - `name` string, required — Display name for this coverage option.
      - `description` string, nullable — Longer explanation of this coverage option.
      - `learn_more_url` string, nullable — Link to learn more about this coverage option.
      - `from_price` number, double, nullable — Lowest applicable monthly price for this coverage option.
      - `benefits` PlanCoverageOptionBenefitResponse[], nullable — Benefit items included with this coverage option.
        - `name` string, required — Benefit name.
        - `description` string, nullable — Benefit description.
      - `sub_options` PlanCoverageOptionResponse[], nullable — Nested sub-options available when this option is selected.
      - `eligibility_criteria` EmployerEligibilityCriterionResponse[], nullable — Eligibility criteria that must be met to select this coverage option.
        - `type` 'employees_count' | 'members_count' | 'industry_exclusions', required
        - `description` string, required — Human-readable description of the criterion.
        - `employees_count` EmployeesCountDetails
          - `min` integer, nullable — Minimum number of employees required.
          - `max` integer, nullable — Maximum number of employees allowed.
        - `members_count` MembersCountDetails
          - `min` integer, nullable — Minimum number of members required.
          - `max` integer, nullable — Maximum number of members allowed.
        - `industry_exclusions` IndustryExclusionsDetails
          - `excluded_industries` string[], required — List of excluded industries.
  - `disclosures` DisclosureResponse[], required — Disclosures associated with this intent.
    - `category` 'regulatory' | 'provider' | 'intermediary', required
    - `type` 'intermediary_role' | 'intermediary_commission' | 'underwriter_disclaimer' | 'anti_selection_notice' | 'statement_of_needs' | 'product_information' | 'pre_existing_conditions' | 'statutory_warning', required
    - `text` string, required — The disclosure statement text.
  - `action_required` DependentsManagementIntentActionRequiredResponse
    - `code` 'remove_restricted_or_ineligible_dependents', required
    - `reason` string, required — Brief reason for the required action.
    - `reason_description` string, required — Detailed description of the required action. This is intended to be understandable by the end user.
    - `due_by` string, date-time, required — The deadline by which the action must be completed. The day is included (i.e. the action can be completed any time during this day in the user's local time).

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/revisions/85bb8b3c42b4/schema)