# Vitable Docs ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.vitablehealth.com/_mcp/server ## Docs - [Overview](https://developer.vitablehealth.com/.md): Launch health benefits inside your platform in days, not months. - [Authentication](https://developer.vitablehealth.com/getting-started/authentication.md): How to authenticate with Vitable's API using API keys and bound access tokens. - [Migrating to SDK v1.0](https://developer.vitablehealth.com/getting-started/sdk-migration.md): What changed in the v1.0 release of the Vitable Connect SDKs, and how to upgrade from a 0.x version. - [Quickstart](https://developer.vitablehealth.com/embedded_benefits/quickstart.md): Make your first Vitable API call and embed the Employee Dashboard in under 5 minutes. - [Employer Onboarding](https://developer.vitablehealth.com/embedded_benefits/guides/employer-onboarding.md): Set up an employer from scratch — create the company and import employees. - [Employee Enrollment](https://developer.vitablehealth.com/embedded_benefits/guides/employee-enrollment.md): Set up the employee benefits experience — embed the enrollment widget and handle enrollment events. - [Benefits Administration](https://developer.vitablehealth.com/embedded_benefits/guides/benefits-administration.md): Manage your workforce after setup — update rosters, monitor lifecycle events, and handle payroll deductions. - [Census Sync](https://developer.vitablehealth.com/embedded_benefits/concepts/census-sync.md): How to submit employee data in bulk via census sync, monitor async processing, and handle validation errors. - [Employee Lifecycle](https://developer.vitablehealth.com/embedded_benefits/concepts/employee-lifecycle.md): How employees transition between statuses in the Vitable API and which webhook events signal each change. - [Enrollment Lifecycle](https://developer.vitablehealth.com/embedded_benefits/concepts/enrollment-lifecycle.md): How enrollments move through statuses and which webhook events fire at each transition. - [Payroll Deductions](https://developer.vitablehealth.com/embedded_benefits/concepts/payroll-deductions.md): How to receive employee deduction events and fetch deduction data for payroll integration. - [Group Onboarding](https://developer.vitablehealth.com/embedded_care/guides/group-onboarding.md): Create a group, the container your members belong to. Lists the plans you can subscribe them to and walks through creating your first group. - [Group Member Sync](https://developer.vitablehealth.com/embedded_care/guides/group-member-sync.md): Submit your member roster for a group. Vitable provisions accounts and starts plan subscriptions asynchronously. - [Groups](https://developer.vitablehealth.com/embedded_care/concepts/groups.md): What a group is in Vitable, how it relates to plans and members, and how its lifecycle works. - [Member Lifecycle](https://developer.vitablehealth.com/embedded_care/concepts/member-lifecycle.md): What happens to a member from the moment they appear in a sync — provisioning, authentication, plan subscription, removal, and re-add. - [Member Sync](https://developer.vitablehealth.com/embedded_care/concepts/member-sync.md): How member sync works under the hood — the replacement model, reference matching, async processing, and how to read the results. - [Vitable Drops](https://developer.vitablehealth.com/drops.md): Embed complete Vitable experiences in your application with secure pre-built widgets. - [Set Up Vitable Drops](https://developer.vitablehealth.com/drops/get-started.md): Install the SDK, issue secure bound tokens, and configure the shared React provider. - [Employee Dashboard Widget](https://developer.vitablehealth.com/drops/employee-dashboard.md): Embed Vitable's employee benefits dashboard into your application with the Vitable Connect SDK. - [Employer Benefits Widget](https://developer.vitablehealth.com/drops/employer-benefits.md): Embed Vitable's benefits administration dashboard into your application so employers can manage plans, enrollments, and coverage. - [Employer Billing Widget](https://developer.vitablehealth.com/drops/employer-billing.md): Embed Vitable's billing dashboard into your application so employers can view invoices, payments, and billing history. - [Webhooks](https://developer.vitablehealth.com/webhooks.md): Receive real-time notifications when events happen in your Vitable integration. - [Events](https://developer.vitablehealth.com/webhooks/events.md): All webhook event types and when they are triggered. - [Verifying Signatures](https://developer.vitablehealth.com/webhooks/signatures.md): Validate that webhook requests came from Vitable using HMAC-SHA512 signatures. - [Reliability](https://developer.vitablehealth.com/webhooks/reliability.md): Retry behavior, circuit breaker, delivery guarantees, and best practices. ## API Docs - API Reference > Auth [Issue Access Token](https://developer.vitablehealth.com/api/auth/issue-access-token.md) - API Reference > Employees [Retrieve](https://developer.vitablehealth.com/api/employees/get.md) - API Reference > Employees [Update](https://developer.vitablehealth.com/api/employees/update.md) - API Reference > Employees [List Enrollments](https://developer.vitablehealth.com/api/employees/list-enrollments.md) - API Reference > Employers [List](https://developer.vitablehealth.com/api/employers/list.md) - API Reference > Employers [Create](https://developer.vitablehealth.com/api/employers/create.md) - API Reference > Employers [Retrieve](https://developer.vitablehealth.com/api/employers/get.md) - API Reference > Employers [Update](https://developer.vitablehealth.com/api/employers/update.md) - API Reference > Employers [Submit Census Sync](https://developer.vitablehealth.com/api/employers/submit-census-sync.md) - API Reference > Employers [List Employees](https://developer.vitablehealth.com/api/employers/list-employees.md) - API Reference > Employers [Update Settings](https://developer.vitablehealth.com/api/employers/update-settings.md) - API Reference > Employers [List HRIS Providers](https://developer.vitablehealth.com/api/employers/list-hris-providers.md) - API Reference > Employers [Retrieve HRIS](https://developer.vitablehealth.com/api/employers/get-hris.md) - API Reference > Employers [List Benefit Plan Years](https://developer.vitablehealth.com/api/employers/list-benefit-plan-years.md) - API Reference > Employers [Retrieve Benefit Plan Year](https://developer.vitablehealth.com/api/employers/get-benefit-plan-year.md) - API Reference > Employers [List Benefit Plan Year Enrollments](https://developer.vitablehealth.com/api/employers/list-benefit-plan-year-enrollments.md) - API Reference > Employers [List Invoices](https://developer.vitablehealth.com/api/employers/list-invoices.md) - API Reference > Employers [Retrieve Invoice Pdf](https://developer.vitablehealth.com/api/employers/get-invoice-pdf.md) - API Reference > Employers [Retrieve Payroll Access Setup](https://developer.vitablehealth.com/api/employers/get-payroll-access-setup.md) - API Reference > Employers [Submit Payroll Access Setup](https://developer.vitablehealth.com/api/employers/submit-payroll-access-setup.md) - API Reference > Employers [List Payroll Deduction Statements](https://developer.vitablehealth.com/api/employers/list-payroll-deduction-statements.md) - API Reference > Employers [Ensure Payroll Integration Email](https://developer.vitablehealth.com/api/employers/ensure-payroll-integration-email.md) - API Reference > Employers [List an employer's ACA full-time employees](https://developer.vitablehealth.com/api/employers/list-employer-aca-full-time-employees.md) - API Reference > Enrollments [Retrieve](https://developer.vitablehealth.com/api/enrollments/get.md) - API Reference > Enrollments [Reissue](https://developer.vitablehealth.com/api/enrollments/reissue.md) - API Reference > Enrollments [Terminate](https://developer.vitablehealth.com/api/enrollments/terminate.md) - API Reference > Enrollments [Get carrier questions and saved responses](https://developer.vitablehealth.com/api/enrollments/get-carrier-question-responses.md) - API Reference > Enrollments [Save carrier-question responses](https://developer.vitablehealth.com/api/enrollments/save-carrier-question-responses.md) - API Reference > Enrollments [Select or revalidate an enrollment plan](https://developer.vitablehealth.com/api/enrollments/select-enrollment-plan.md) - API Reference > Webhook Events [List](https://developer.vitablehealth.com/api/webhook-events/list.md) - API Reference > Webhook Events [Retrieve](https://developer.vitablehealth.com/api/webhook-events/get.md) - API Reference > Webhook Events [List Deliveries](https://developer.vitablehealth.com/api/webhook-events/list-deliveries.md) - API Reference > Groups [List](https://developer.vitablehealth.com/api/groups/list.md) - API Reference > Groups [Create](https://developer.vitablehealth.com/api/groups/create.md) - API Reference > Groups [Retrieve](https://developer.vitablehealth.com/api/groups/get.md) - API Reference > Groups [Update](https://developer.vitablehealth.com/api/groups/update.md) - API Reference > Groups > Members > Sync [Submit](https://developer.vitablehealth.com/api/groups/members/sync/submit.md) - API Reference > Groups > Members > Sync [Retrieve](https://developer.vitablehealth.com/api/groups/members/sync/get.md) - API Reference > Members [List](https://developer.vitablehealth.com/api/members/list.md) - API Reference > Members [Retrieve](https://developer.vitablehealth.com/api/members/get.md) - API Reference > Members [List Dependents](https://developer.vitablehealth.com/api/members/list-dependents.md) - API Reference > Members [List Employments](https://developer.vitablehealth.com/api/members/list-employments.md) - API Reference > Members [List Enrollments](https://developer.vitablehealth.com/api/members/list-enrollments.md) - API Reference > Members [Retrieve Household](https://developer.vitablehealth.com/api/members/get-household.md) - API Reference > Members [List ID Cards](https://developer.vitablehealth.com/api/members/list-id-cards.md) - API Reference > Members [List Qualifying Life Events](https://developer.vitablehealth.com/api/members/list-qualifying-life-events.md) - API Reference > Members [List member enrollment history log](https://developer.vitablehealth.com/api/members/list-member-enrollment-audits.md) - API Reference > Members [List member ICHRA payment accounts](https://developer.vitablehealth.com/api/members/list-member-ichra-payment-accounts.md) - API Reference > Members [Create member card reveal session](https://developer.vitablehealth.com/api/members/create-member-card-embed-session.md) - API Reference > Members [Create an approved member qualifying life event](https://developer.vitablehealth.com/api/members/create-qualifying-life-event.md) - API Reference > Members [List qualifying life event types](https://developer.vitablehealth.com/api/members/list-qualifying-life-event-types.md) - API Reference > Organizations [List](https://developer.vitablehealth.com/api/organizations/list.md) - API Reference > Plans [List](https://developer.vitablehealth.com/api/plans/list.md) - API Reference > Carrier Applications [Get a carrier application](https://developer.vitablehealth.com/api/carrier-applications/get-carrier-application.md) - API Reference > Carrier Applications [Assign Carrier Application](https://developer.vitablehealth.com/api/carrier-applications/assign-carrier-application.md) - API Reference > Organization Domains [List the organization's email domains](https://developer.vitablehealth.com/api/organization-domains/list-organization-domains.md) - API Reference > Organization Domains [Request an email domain](https://developer.vitablehealth.com/api/organization-domains/request-organization-domain.md) - API Reference > Organization Domains [Remove a claimed email domain](https://developer.vitablehealth.com/api/organization-domains/remove-organization-domain.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developer.vitablehealth.com/openapi.json) - [OpenAPI YAML](https://developer.vitablehealth.com/openapi.yaml)