Skip to main content
Your platform is the system of record for who works where. Census sync keeps Prescience matched to it with three operations:
A successful census write starts or refreshes the group’s market comparison. Its response reports census acceptance only; it never returns an iframe URL. When an employer later opens the Prescience offer, create a separate POST /groups/{groupId}/embed-sessions request as described in the Bolto iframe guide.
The same calls work before and after enrollment. Before, they edit the quoting census. After, they also propagate to the live company roster; coverage and member invitations follow from there. You don’t change your code at activation.
Hook these calls into the same internal events that drive your payroll changes. If your system emits “employee terminated”, the Prescience sync is one webhook consumer away.

​
New hires

Response (201)
Same member schema as the bulk census. Store the returned memberId against your employee record; it’s the handle for every later update. For an enrolled group, send the full enrollment fields (firstName, lastName, email) up front so the new hire gets their Prescience invitation immediately. Bulk-first is also fine: PUT /census upserts by email, so re-pushing the whole roster on a nightly job is a valid (if blunter) sync strategy. Mind the census write limit of 20/min.

​
Updates

PATCH sends only the fields that changed:
Address moves, name changes, status flips: all the same call. In-force pricing doesn’t re-rate mid-year; census changes affect the next renewal.

​
Terminations and COBRA

Terminate with a status change. Set cobra: true when the employee and covered family members are eligible to receive a COBRA offer. This does not elect or activate coverage:
Response (200)
What happens next, for an enrolled group:
  • Without COBRA: coverage ends per the termination date; the member drops from active rating and the roster shows terminated.
  • With continuation eligibility: Prescience creates independent employee/dependent election rights and starts the employer-configured continuation notice workflow (contractual continuation for the current live plans, and federal COBRA only when that applicability is approved). The roster remains terminated while carrier proof, elections, or initial payment are pending. It changes to cobra with cobra.until only after that employee’s carrier proof is verified, Diamond is elected, and the required premium is matched to an incoming Lemma deposit; waivers, lapses, and unpaid elections never count as active coverage.
For a live enrolled group, include coverageLossDate, the current household mailing address, and the covered-dependent roster. personalEmail is optional; when no usable non-work address and affirmative electronic-delivery consent are on file, Prescience queues a printable paper notice for the employer to mail and confirm. Terminated members are excluded from quoting immediately; pre-enrollment, a re-quote after a termination reflects it on the next POST /quotes.

​
Confirmation

Census writes are confirmed two ways: the synchronous response you already have, and the census.processed webhook with the same counts (received, accepted, memberCount), useful when the team operating the sync isn’t the team that owns the request path.