Build and submit an X12 834 benefit enrollment transaction

domain: x12.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Assemble the ISA/GS envelope for transaction set 834 (Benefit Enrollment and Maintenance) with your sender ID (the employer or benefits administrator) and the receiver ID (the health plan or TPA)
  2. Construct the BGN segment to indicate whether this is an initial enrollment file, a change file, or a full replacement file; replacement files replace all existing enrollment data for the group, so use them only when intended
  3. For each member, build an INS segment specifying the member's relationship to the subscriber (self, spouse, child) and the maintenance type code indicating whether this is an addition, change, or termination of coverage
  4. Add REF segments for member IDs (SSN, member ID), DTP segments for coverage effective and termination dates, and NM1/PER segments for member demographics and contact information
  5. Include HD segments to specify the health coverage plan code, coverage type, and insurance line for each plan the member is enrolling in; attach COB segments if the member has other insurance
  6. Close with SE, GE, and IEA trailers and transmit to the health plan via the agreed channel (SFTP or API with YOUR_TOKEN); confirm receipt of a 999 functional acknowledgment before considering the enrollment submitted

Known gotchas

Related routes

Build an X12 834 benefit enrollment transaction for a new hire group enrollment event and handle the subscriber and dependent demographic and coverage loops correctly
x12.org · 6 steps · unrated
Process X12 834 benefit enrollment files
insurance-general · 6 steps · unrated
Submit benefits enrollment data for new hires to a carrier using the ANSI X12 834 EDI transaction set via a clearinghouse
x12.org · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans