Skip to main content
COBRA Events is available at route /hr/benefits/cobra, guarded by hr.benefits.admin.

​
Overview

The COBRA Events List page shows all COBRA qualifying events for the organization with filterable tabs by status (all, pending_notice, notice_sent, elected, declined, terminated, expired). Each event row shows the employee avatar and name, qualifying event label, event date, a deadline indicator (overdue, within 7 days warning, or formatted date), and a status badge. The DeadlineIndicator component highlights overdue or soon-due notices. An event count badge appears on each status tab. Row actions include viewing the event detail and sending a notice if applicable.

​
Who it’s for

hr.benefits.admin — HR benefits administrators only.

​
Before you start

  • hr.benefits.admin permission required.
  • COBRA qualifying events must have been recorded for terminated or life-event employees.

​
Steps

1

Open COBRA Events

Navigate to /hr/benefits/cobra.
2

Filter by status

Click a status tab to show only events in that lifecycle stage.
3

Check deadlines

Look for overdue or warning indicators in the deadline column.
4

Open event detail

Click a row to navigate to /hr/benefits/cobra/:id for full detail and actions.

​
Key concepts

​
Viewing a COBRA event

The COBRA Event Details page is available at route /hr/benefits/cobra/:id, guarded by hr.benefits.admin. It loads a single COBRA qualifying event by :id. The breadcrumb reflects the qualifying event type. The page shows event details (employee name with avatar, qualifying event label, event date, coverage period deadlines), an election form section (CobraElectionForm toggled by a Record Election button), event timeline, and status management. Available actions depend on event status: pending_notice enables Send Notice which calls sendNotice.mutateAsync; status can also be updated via updateStatus. The COBRA_COVERAGE_PERIODS and COBRA_QUALIFYING_EVENT_LABELS constants from the COBRA types module provide display labels. Before you start: hr.benefits.admin permission required. Navigate from /hr/benefits/cobra.
  1. Navigate from /hr/benefits/cobra and click an event row.
  2. Check employee, qualifying event type, event date, and deadline status.
  3. If status is pending_notice, click Send Notice to send the COBRA notice.
  4. Click Record Election to open the CobraElectionForm and capture the beneficiary’s decision.
  5. Use status update actions as the event progresses through its lifecycle.
Key detail concepts:

Human Resources

Human Resources core overview.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/hr.tsx
  • src/routes/hr/benefits-routes.tsx
  • src/cores/hr/benefits/pages/admin/CobraEventsListPage.tsx
  • src/cores/hr/benefits/pages/admin/CobraEventDetailPage.tsx
  • src/cores/hr/benefits/hooks/useCobraEvents.ts
  • src/cores/hr/benefits/types/cobra.ts