Skip to main content
PATCH
Update or terminate a member

Authorizations

Authorization
string
header
required

Partner API key. psk_test_<32 hex> for test mode, psk_live_<32 hex> for live mode. Keys are stored hashed and cannot be recovered; store them in your secrets manager on issue.

Path Parameters

groupId
string
required

Group ID, e.g. grp_8c2f41d09a3e.

Pattern: ^grp_[0-9a-f]{12}$
memberId
string
required

Census member ID, e.g. mem_92e4b7a1d0c6.

Pattern: ^mem_[0-9a-f]{12}$

Body

application/json

Partial update: send only the fields you are changing. Terminate with status: "terminated" plus optional terminationDate and cobra.

externalId
string

Your employee ID. Used as the upsert key when email is absent.

Example:

"emp_0001"

firstName
string
Example:

"Jordan"

lastName
string
Example:

"Reyes"

email
string<email>

Upsert key when present.

Example:

"jordan@acme.com"

dob
string<date>
Example:

"1992-03-14"

age
integer

Alternative to dob. One of the two is required.

Example:

34

zip
string

5-digit home ZIP. Drives the area factor in rating.

Pattern: ^[0-9]{5}$
Example:

"94110"

sexAtBirth
enum<string>
Available options:
male,
female,
other
employmentType
enum<string>
Available options:
full_time,
part_time,
contractor
hireDate
string<date>
Example:

"2024-03-01"

status
enum<string>
default:active
Available options:
active,
terminated
dependents
object[]
Maximum array length: 6
terminationDate
string<date>
Example:

"2026-11-15"

cobra
boolean

Offer COBRA continuation on termination.

Response

Updated member.

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.

dob
string<date>
required
Example:

"1992-03-14"

zip
string
required

5-digit home ZIP. Drives the area factor in rating.

Pattern: ^[0-9]{5}$
Example:

"94110"

memberId
string
required

Server-assigned ID. Use it for PATCH /groups/{groupId}/members/{memberId}.

Example:

"mem_c4a91f27e83d"

externalId
string

Your employee ID. Used as the upsert key when email is absent.

Example:

"emp_0001"

firstName
string
Example:

"Jordan"

lastName
string
Example:

"Reyes"

email
string<email>

Upsert key when present.

Example:

"jordan@acme.com"

age
integer

Alternative to dob. One of the two is required.

Example:

34

sexAtBirth
enum<string>
Available options:
male,
female,
other
employmentType
enum<string>
Available options:
full_time,
part_time,
contractor
hireDate
string<date>
Example:

"2024-03-01"

status
enum<string>
default:active
Available options:
active,
terminated
dependents
object[]
Maximum array length: 6