Sign in

v2

latestOpenAPI 3.1.12026-08-0785394779.1 KB
Group Policy Intents

Create a group policy intent

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.

post/group_policy_intents

Headers

X-Platform-Idstring

The target platform id. Required only when calling with a dashboard (WorkOS AuthKit) access token instead of a platform API key — the token carries no platform claim, so the caller must say which platform it means. Ignored for platform API key / embed session token callers.

Request body

quote_intent_idstring required

Unique identifier for the group quote intent to create a policy intent from

Example request

{
  "quote_intent_id": "gqi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "cost_sharing": {
    "member_count": {
      "adults": 123,
      "children": 123
    },
    "member_selection": {
      "partner": true,
      "children": true
    },
    "percentage": {
      "percentage": 123
    }
  }
}

Response

OK

idstring required

Unique identifier for the group policy intent

group_idstring required

Unique identifier for the group

plan_idstring required

Unique identifier for the plan

quote_intent_idstring 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_datestring date-time nullable

Due date for the policy intent

objectstring

Object type identifier

Example response

{
  "id": "gpi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "group_id": "gr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "quote_intent_id": "gqi_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "due_date": "2024-12-01T00:00:00Z",
  "cost_sharing": {
    "member_count": {
      "adults": 123,
      "children": 123
    },
    "member_selection": {
      "partner": true,
      "children": true
    },
    "percentage": {
      "percentage": 123
    }
  },
  "action_required": {
    "due_by": "2024-12-01T00:00:00Z"
  }
}