Partner-run enrollment

​

Submit elections

{
  "elections": [
    {
      "externalId": "emp_1",
      "election": "enrolled",
      "tier": "employeeSpouse",
      "dependents": [{ "relationship": "spouse" }],
      "effectiveDate": "2026-11-01"
    },
    { "externalId": "emp_2", "election": "waived", "waiverReason": "other_employer_group" }
  ]
}

• Identify each employee by memberId or externalId.
• election is enrolled or waived. effectiveDate (YYYY-MM-DD) is required for an enrolled election; waiverReason is optional on a waiver.
• tier (employeeOnly, employeeSpouse, employeeChildren, family) must match the covered dependents (relationship: spouse, domestic_partner, child or other; dob and name optional).
• Up to 10,000 elections per request. Send an Idempotency-Key to make a retry safe.
• Valid rows are applied; invalid rows come back in errors by index. The response is 400 invalid_request when no row is valid, and 409 conflict until the group’s enrollment exists.

{
  "groupId": "grp_8c2f41d09a3e",
  "received": 2,
  "accepted": 2,
  "enrolled": 1,
  "waived": 1,
  "invited": 0,
  "invitesSuppressed": "test-mode",
  "deductionsWebhook": true,
  "errors": []
}

​

Payroll deductions

{
  "groupId": "grp_8c2f41d09a3e",
  "reason": "elections",
  "members": [
    {
      "memberId": "mem_41b7c20d9e3a",
      "externalId": "emp_1",
      "coverage": { "status": "enrolled", "tier": "family", "effectiveDate": "2026-11-01" },
      "deduction": { "medical": { "employeeMonthlyCents": 12240 } }
    }
  ]
}