> ## Documentation Index
> Fetch the complete documentation index at: https://beta-docs.vitablehealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create benefit eligibility policy

> Create a new benefit eligibility policy for a company.
This allows payroll providers to configure eligibility rules determining
which employees qualify for benefits based on employment classification
and waiting periods.




## OpenAPI

````yaml external-api-schema.yml post /v1/companies/{company_id}/benefit-eligibility-policies
openapi: 3.0.3
info:
  title: Vitable External Partner API
  version: 1.0.0
  description: >
    External API for Payroll Providers and PEO platforms to integrate with
    Vitable health plan products 

    for benefit administration. This API enables partner systems to manage
    benefit enrollment, 

    employee data, and plan information for their clients.


    Common integration scenarios:

    - Retrieve active benefit plans for employers

    - List enrolled employees for benefit periods  

    - Create and update employee records

    - Manage benefit enrollments and elections

    - Access enrollment status and eligibility information
servers:
  - url: https://api.vitablehealth.com
    description: Production server
  - url: https://api-staging.vitablehealth.com
    description: Staging server
security:
  - partnerApiKey: []
tags:
  - name: Company Benefits
    description: Benefit plans available to companies (plan years)
  - name: Company Members
    description: Employee management and information
  - name: Benefit Enrollments
    description: Employee benefit enrollment status and management
  - name: Member Benefits
    description: Individual employee benefit information
  - name: Benefit Eligibility
    description: Employee benefit eligibility information
  - name: Payroll Integration
    description: Payroll deduction and contribution calculations
  - name: Quoting
    description: Marketplace plan searches and insurance quotes
paths:
  /v1/companies/{company_id}/benefit-eligibility-policies:
    post:
      tags:
        - Benefit Eligibility
      summary: Create benefit eligibility policy
      description: |
        Create a new benefit eligibility policy for a company.
        This allows payroll providers to configure eligibility rules determining
        which employees qualify for benefits based on employment classification
        and waiting periods.
      operationId: create_employee_benefit_eligibility_policy
      parameters:
        - in: path
          name: company_id
          schema:
            type: string
            format: uuid
          required: true
          description: Unique identifier for the company
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/CreateEmployeeBenefitEligibilityPolicyRequest
      responses:
        '200':
          description: Benefit eligibility policy created successfully
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CreateEmployeeBenefitEligibilityPolicyResponse
      security:
        - partnerApiKey: []
components:
  schemas:
    CreateEmployeeBenefitEligibilityPolicyRequest:
      type: object
      description: Request to create a benefit eligibility policy
      properties:
        classification:
          $ref: >-
            #/components/schemas/EmployeeBenefitEligibilityPolicyClassificationEnum
        waiting_period:
          $ref: >-
            #/components/schemas/EmployeeBenefitEligibilityPolicyWaitingPeriodEnum
      required:
        - classification
        - waiting_period
    CreateEmployeeBenefitEligibilityPolicyResponse:
      type: object
      description: Response from creating a benefit eligibility policy
      properties:
        eligibility_policy:
          $ref: '#/components/schemas/EmployeeBenefitEligibilityPolicy'
      required:
        - eligibility_policy
    EmployeeBenefitEligibilityPolicyClassificationEnum:
      type: string
      enum:
        - Full time
        - Part time
        - All
      description: |
        Employee classification for benefit eligibility:
        * `Full time` - Full-time employees only
        * `Part time` - Part-time employees only
        * `All` - All employees regardless of classification
    EmployeeBenefitEligibilityPolicyWaitingPeriodEnum:
      type: string
      enum:
        - 1st of the following month
        - 30 days
        - 60 days
        - None
      description: >
        Waiting period before benefit eligibility:

        * `1st of the following month` - Eligibility starts first day of
        following month

        * `30 days` - 30-day waiting period from hire date

        * `60 days` - 60-day waiting period from hire date

        * `None` - Immediate eligibility
    EmployeeBenefitEligibilityPolicy:
      type: object
      description: Benefit eligibility policy configuration
      properties:
        id:
          type: string
          format: uuid
          description: Policy identifier
        company_id:
          type: string
          format: uuid
          description: Company identifier
        classification:
          $ref: >-
            #/components/schemas/EmployeeBenefitEligibilityPolicyClassificationEnum
        waiting_period:
          $ref: >-
            #/components/schemas/EmployeeBenefitEligibilityPolicyWaitingPeriodEnum
        active:
          type: boolean
          description: Whether the policy is currently active
        created:
          type: string
          format: date-time
          description: Policy creation timestamp
        updated:
          type: string
          format: date-time
          description: Policy last update timestamp
      required:
        - id
        - company_id
        - classification
        - waiting_period
        - active
        - created
        - updated
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````