---
title: "Add a member"
method: POST
path: "/groups/{groupId}/members"
tags: ["Census"]
---

# Add a member

`POST /groups/{groupId}/members`

Adds one member to the census: the new-hire path. After enrollment, additions propagate to the live company census automatically.

## Path parameters

- `groupId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- union — One employee. `zip` plus one of `dob` | `age` is enough to quote. `firstName`, `lastName`, and `email` are additionally required (per active member) at enrollment time.
  - object
    - `externalId` string — Your employee ID. Used as the upsert key when `email` is absent.
    - `firstName` string
    - `lastName` string
    - `email` string, email — Upsert key when present.
    - `dob` string, date, required
    - `age` integer — Alternative to `dob`. One of the two is required.
    - `zip` string, required — 5-digit home ZIP. Drives the area factor in rating.
    - `sexAtBirth` 'male' | 'female' | 'other'
    - `employmentType` 'full_time' | 'part_time' | 'contractor'
    - `hireDate` string, date
    - `status` 'active' | 'terminated'
    - `dependents` Dependent[]
      - `relationship` 'spouse' | 'domestic_partner' | 'child' | 'other', required
      - `dob` string, date
      - `name` string
  - object
    - `externalId` string — Your employee ID. Used as the upsert key when `email` is absent.
    - `firstName` string
    - `lastName` string
    - `email` string, email — Upsert key when present.
    - `dob` string, date
    - `age` integer, required — Alternative to `dob`. One of the two is required.
    - `zip` string, required — 5-digit home ZIP. Drives the area factor in rating.
    - `sexAtBirth` 'male' | 'female' | 'other'
    - `employmentType` 'full_time' | 'part_time' | 'contractor'
    - `hireDate` string, date
    - `status` 'active' | 'terminated'
    - `dependents` Dependent[]
      - `relationship` 'spouse' | 'domestic_partner' | 'child' | 'other', required
      - `dob` string, date
      - `name` string

## Response `201`

Member stored.

- union
  - object
    - `memberId` string, required — Server-assigned ID. Use it for `PATCH /groups/{groupId}/members/{memberId}`.
  - object
    - `memberId` string, required — Server-assigned ID. Use it for `PATCH /groups/{groupId}/members/{memberId}`.

## Other responses

- `400` — Validation failed.
- `401` — Missing, malformed, or revoked API key.
- `404` — No such resource in this mode. Test keys only see test resources; live keys only see live resources.
- `429` — Rate limit exceeded. Honor `Retry-After`.
- `500` — Something failed on our side. Safe to retry with the same `Idempotency-Key`.

---

[API](https://skmtc.dev/getprescience/apis/prescience-partner-api.md) · [All operations](https://skmtc.dev/getprescience/apis/prescience-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getprescience/prescience-partner-api/revisions/eb1f377f8139/schema)