---
title: "Create a group policy intent"
method: POST
path: "/group_policy_intents"
tags: ["Group Policy Intents"]
---

# Create a group policy intent

`POST /group_policy_intents`

Creates a `group_policy_intent` from a `group_quote_intent` that has a quote available. The intent coordinates the policy setup workflow including requirements collection and policy creation.

## Headers

- `X-Platform-Id` string

## Request body

- CreateGroupPolicyIntentRequest
  - `quote_intent_id` string, required — Unique identifier for the group quote intent to create a policy intent from
  - `cost_sharing` HealthInsuranceCostSharingConfigurationResponse
    - `type` 'member_count' | 'member_selection' | 'percentage' | 'policyholder_only' | 'family_type', required
    - `member_count` HealthInsuranceMemberCountCostSharingConfigurationResponse
      - `adults` integer, required — Number of additional adults covered, including partner/spouse.
      - `children` integer, required — Number of additional children covered.
    - `member_selection` HealthInsuranceMemberSelectionCostSharingConfigurationResponse
      - `partner` boolean, required — If a spouse/partner is covered.
      - `children` boolean, required — If children are covered.
    - `percentage` HealthInsurancePercentageCostSharingConfigurationResponse
      - `percentage` integer, required — Employer coverage percentage: For 40% send 40. For 100% send 100.
    - `family_type` HealthInsuranceFamilyTypeCostSharingConfigurationResponse
      - `type` 'single' | 'couple' | 'single_with_children' | 'family', required
  - `consent_approvals` ConsentApprovalInput[], nullable — Consent approvals to record at the time of intent creation
    - `type` 'terms_of_business' | 'privacy_policy', required
    - `ip` string, required — IP address of the user approving
    - `version` string, required — Version of the consent document being approved
    - `user_id` string, required — User ID approving the consent

## Response `200`

OK

- GroupPolicyIntentResponse
  - `id` string, required — Unique identifier for the group policy intent
  - `group_id` string, required — Unique identifier for the group
  - `plan_id` string, required — Unique identifier for the plan
  - `quote_intent_id` string, required — Unique identifier for the group quote intent this policy intent was created from
  - `status` 'processing' | 'action_required' | 'pending_provider_approval' | 'policy_created' | 'expired' | 'provider_rejected' | 'manual_renewal_gathering_required', required
  - `due_date` string, date-time, nullable — Due date for the policy intent
  - `cost_sharing` HealthInsuranceCostSharingConfigurationResponse
    - `type` 'member_count' | 'member_selection' | 'percentage' | 'policyholder_only' | 'family_type', required
    - `member_count` HealthInsuranceMemberCountCostSharingConfigurationResponse
      - `adults` integer, required — Number of additional adults covered, including partner/spouse.
      - `children` integer, required — Number of additional children covered.
    - `member_selection` HealthInsuranceMemberSelectionCostSharingConfigurationResponse
      - `partner` boolean, required — If a spouse/partner is covered.
      - `children` boolean, required — If children are covered.
    - `percentage` HealthInsurancePercentageCostSharingConfigurationResponse
      - `percentage` integer, required — Employer coverage percentage: For 40% send 40. For 100% send 100.
    - `family_type` HealthInsuranceFamilyTypeCostSharingConfigurationResponse
      - `type` 'single' | 'couple' | 'single_with_children' | 'family', required
  - `action_required` GroupPolicyIntentActionRequiredResponse
    - `code` 'provide_dependant_information' | 'provide_beneficiary_information' | 'provide_missing_information', required
    - `reason` string, required — Brief reason for the required action.
    - `reason_description` string, required — Detailed description of the required action.
    - `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).
  - `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.
  - `object` string — Object type identifier

## 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)