---
title: "Add an employee to a group"
method: POST
path: "/groups/{group_id}/employees"
tags: ["Groups"]
---

# Add an employee to a group

`POST /groups/{group_id}/employees`

Adds an existing employee to a `group`. The employee must belong to the same employer as the `group`. If there is a `group_policy` associated with the `group`, a corresponding `enrolment_intent` will be created for the employee.

## Path parameters

- `group_id` string, required

## Headers

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

## Request body

- AddEmployeeToGroupRequest
  - `employee_id` string, required — Employee Id
  - `create_enrolment_intents` boolean, nullable — Controls whether enrolment intents are automatically created for the employee. Defaults to `true` for hosted platforms. When `true` on a hosted platform, the response includes an `enrolment_intent_id`. For non-hosted platforms, the `enrolment_intent_id` is not included in the response, subscribe to the `enrolment_intent.processing` webhook to be notified when the enrolment intent is created.
  - `policy_configuration` PolicyConfigurationRequest
    - `desired_policy_start_date` string, date, nullable — The desired date for the employee's policy to start. This date is not guaranteed to be honored by the insurance provider and may be adjusted based on provider-specific rules and requirements. If unspecified, the policy start date will be determined by the insurance provider.
    - `enrolment_date` string, date, nullable — The date on which the employee agreed to enrol into the group's policies. This date may be used by some insurance providers to determine the policy start date. If unspecified, the enrolment date will default to the date the enrolment intent is processed.

## Response `200`

OK

- GroupEmployeeResponse
  - `object` string — The object type
  - `id` string, required — Unique identifier for the employee.
  - `group_id` string, required — Unique identifier for the group.
  - `policies` PolicyReference[], required — List of policies associated with the employee in this group.
    - `id` string, required — Unique identifier for the policy.
  - `enrolments` EnrolmentReference[], required — List of enrolments associated with the employee in this group.
    - `id` string, required — Unique identifier for the enrolment.
  - `desired_policy_start_date` string, date, nullable — The desired date for the employee's policy to start. This date is not guaranteed to be honored by the insurance provider and may be adjusted based on provider-specific rules and requirements.
  - `enrolment_date` string, date, nullable — The date on which the employee agreed to enrol into the group's policies. This date may be used by some insurance providers to determine the policy start date.
  - `eligibility_status` 'pending' | 'eligible' | 'ineligible', required
  - `enrolment_status` 'enrolled' | 'enrolling' | 'opted_out' | 'cancelled' | 'enrolment_available' | 'not_available', required
  - `scheduled_group_transitions` ScheduledGroupTransitionResponse[], required — List of scheduled group transitions for the employee. Only includes pending transitions.
    - `new_group_id` string, required — Unique identifier for the group the employee will be moved to
    - `scheduled_date` string, date, required — The date when the employee will be moved to the new group

## 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/versions/7b8b3ed87c96/schema)