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

# Create a Open Enrollment Member Request

> The open enrollment member request is used to make changes to existing employees, dependents and coverages during the open enrollment period.

<Warning>
  The Member Request workflow is now deprecated in favor of using [Member
  Snapshot](/docs/members/using-snapshots/using-snapshots)
</Warning>


## OpenAPI

````yaml POST /api/v1/employees/{employee_id}/member_requests/open_enrollment
openapi: 3.0.1
info:
  description: Policy management APIs for health and ancillary insurance
  title: Noyo Fulfillment API
  version: 1.0.0
servers:
  - description: Noyo Fulfillment API - Live
    url: https://fulfillment.noyo.com
  - description: Noyo Fulfillment API - Sandbox
    url: https://fulfillment-sandbox.noyo.com
security: []
paths:
  /api/v1/employees/{employee_id}/member_requests/open_enrollment:
    post:
      tags:
        - Member Requests
      summary: Create a Open Enrollment Member Request
      description: >-
        The open enrollment member request is used to make changes to existing
        employees, dependents and coverages during the open enrollment period.
      operationId: openEnrollmentMemberRequest
      parameters:
        - description: The unique identifier of the employee related to the member request
          in: path
          name: employee_id
          required: true
          schema:
            example: 30b74a44-d5b1-4123-a7a4-6d3aec251ba4
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            examples:
              success:
                value:
                  coverages:
                    - carrier_config: {}
                      carrier_id: 9a0a7437-4097-4251-9e71-85384c0eb1c9
                      created: 1557512389
                      lines_of_coverage:
                        medical:
                          adding_coverage:
                            - id: fd62665c-0846-4e9d-bd29-80779b5f685c
                              member_type: dependent
                              plan_id: b988cd26-121a-4dd6-b0be-09399f6ecc0a
                      modified: 1564440756
                      signature_date: '2022-01-15'
            schema:
              $ref: '#/components/schemas/MemberRequestOpenEnrollmentRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              example:
                body:
                  coverages:
                    - carrier_config: {}
                      carrier_id: 9a0a7437-4097-4251-9e71-85384c0eb1c9
                      lines_of_coverage:
                        medical:
                          adding_coverage:
                            - id: fd62665c-0846-4e9d-bd29-80779b5f685c
                              member_type: dependent
                              plan_id: b988cd26-121a-4dd6-b0be-09399f6ecc0a
                      signature_date: '2022-01-15'
                employee_id: 30b74a44-d5b1-4123-a7a4-6d3aec251ba4
                id: f4517b87-275a-42e1-85e5-47ea6ab5312b
                request_type: open_enrollment
                status: processing
                transactions:
                  - 579952dd-9a66-4587-a4f7-72a63bf9ec86
              schema:
                $ref: '#/components/schemas/MemberRequestResult'
          description: Successful Response - Returns the new Member Request
components:
  schemas:
    MemberRequestOpenEnrollmentRequest:
      properties:
        coverages:
          description: List of coverage change actions to complete with a set of carriers
          items:
            allOf:
              - $ref: '#/components/schemas/ApiOpenEnrollmentCarrierCoverages'
            description: Coverage change actions to complete with a carrier
          minItems: 1
          type: array
        event:
          allOf:
            - $ref: '#/components/schemas/ApiBaseOpenEnrollmentEventDetails'
          description: Details about the eligible open enrollment event
      required:
        - coverages
      type: object
      x-field_order:
        - event
        - coverages
    MemberRequestResult:
      properties:
        body:
          description: >-
            Data required to execute a member request, varies depending on the
            request type
          type: object
        completed:
          description: Timestamp indicating when a member request was marked as completed
          readOnly: true
          type: integer
        created:
          description: The date the record was created
          type: integer
        employee_id:
          description: Unique identifier of the employee in Noyo
          format: uuid
          readOnly: true
          type: string
        id:
          description: Unique identifier of the record in Noyo
          format: uuid
          type: string
        modified:
          description: The date the record was last updated
          type: integer
        request_type:
          description: Transaction type for the member request
          enum:
            - demographic
            - new_hire
            - termination
            - open_enrollment
            - qualifying_life_event
            - enrollment_snapshot
            - cobra_enrollment
            - cobra_termination
            - cobra_open_enrollment
            - cobra_qualifying_life_event
          type: string
        result:
          description: >-
            Result from executing the member request, varies depending on the
            request type
          type: object
        status:
          description: Status of the member request
          enum:
            - processing
            - completed
            - failed
            - canceled
          type: string
        transactions:
          description: >-
            List of unique identifiers of all associated member transactions in
            Noyo
          items:
            format: uuid
            type: string
          type: array
        version:
          description: Current version of the record
          format: uuid
          type: string
      required:
        - body
        - created
        - employee_id
        - id
        - modified
        - request_type
        - result
        - status
        - version
      type: object
      x-field_order:
        - id
        - version
        - created
        - completed
        - modified
        - employee_id
        - request_type
        - status
        - transactions
        - body
        - result
    ApiOpenEnrollmentCarrierCoverages:
      properties:
        carrier_config:
          description: Carrier-specific data required for member request
          type: object
        carrier_id:
          description: Unique identifier of the carrier in the Noyo system
          format: uuid
          type: string
        coverage_start_date:
          description: ISO-8601 date string for coverage start date
          pattern: ^([0-9]{4})(-)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
          type: string
        lines_of_coverage:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeLinesOfCoverage'
          description: Adding, removing and modifying information for each line of coverage
        signature_date:
          description: ISO-8601 date string for signature date
          pattern: ^([0-9]{4})(-)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
          type: string
      required:
        - carrier_config
        - carrier_id
        - lines_of_coverage
      type: object
      x-field_order:
        - carrier_id
        - carrier_config
        - signature_date
        - lines_of_coverage
    ApiBaseOpenEnrollmentEventDetails:
      properties:
        event_date:
          description: ISO-8601 date string for open enrollment date
          pattern: ^([0-9]{4})(-)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
          type: string
        event_type:
          description: Open enrollment event type
          enum:
            - open_enrollment
          type: string
      type: object
      x-field_order:
        - event_type
        - event_date
    ApiMembersChangeLinesOfCoverage:
      properties:
        accident:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to accident coverage
        add:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to AD&D coverage
        cancer:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to cancer coverage
        critical_illness:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to critical illness coverage
        dental:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to dental coverage
        health_fund:
          allOf:
            - $ref: '#/components/schemas/MembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to health fund coverage
        hospital_indemnity:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to hospital indemnity coverage
        life:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to life coverage
        ltd:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to LTD coverage
        medical:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to medical coverage
        pharmacy:
          allOf:
            - $ref: '#/components/schemas/MembersChangeCoverageAction'
          description: Member transaction requests relating to pharmacy coverage
        std:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageActionWithVolume'
          description: Member transaction requests relating to STD coverage
        vision:
          allOf:
            - $ref: '#/components/schemas/ApiMembersChangeCoverageAction'
          description: Member transaction requests relating to vision coverage
        wellness:
          allOf:
            - $ref: '#/components/schemas/MembersChangeCoverageAction'
          description: Member transaction requests relating to wellness coverage
      type: object
      x-field_order:
        - medical
        - dental
        - vision
        - life
        - add
        - std
        - ltd
        - accident
        - critical_illness
        - cancer
        - health_fund
        - hospital_indemnity
        - pharmacy
        - wellness
    ApiMembersChangeCoverageAction:
      properties:
        adding_coverage:
          description: Details for members adding coverage
          items:
            $ref: '#/components/schemas/ApiBaseMemberAddingCoveragePriorCoverage'
          type: array
        modifying_coverage:
          description: Details for members modifying coverage
          items:
            $ref: '#/components/schemas/ApiBaseMemberModifyingCoverage'
          type: array
        removing_coverage:
          description: Details for members removing coverage
          items:
            $ref: '#/components/schemas/BaseMemberRemovingCoverage'
          type: array
      type: object
      x-field_order:
        - adding_coverage
        - removing_coverage
        - modifying_coverage
    ApiMembersChangeCoverageActionWithVolume:
      properties:
        adding_coverage:
          description: Details for members adding coverage with volume
          items:
            $ref: >-
              #/components/schemas/ApiBaseMemberAddingCoveragePriorCoverageWithVolume
          type: array
        modifying_coverage:
          description: Details for members modifying coverage with volume
          items:
            $ref: '#/components/schemas/ApiBaseMemberModifyingCoverageWithVolume'
          type: array
        removing_coverage:
          description: Details for members removing coverage
          items:
            $ref: '#/components/schemas/BaseMemberRemovingCoverage'
          type: array
      type: object
      x-field_order:
        - adding_coverage
        - removing_coverage
        - modifying_coverage
    MembersChangeCoverageActionWithVolume:
      properties:
        adding_coverage:
          description: Details for members adding coverage with volume
          items:
            $ref: >-
              #/components/schemas/BaseMemberAddingCoveragePriorCoverageWithVolume
          type: array
        modifying_coverage:
          description: Details for members modifying coverage with volume
          items:
            $ref: '#/components/schemas/BaseMemberModifyingCoverageWithVolume'
          type: array
        removing_coverage:
          description: Details for members removing coverage
          items:
            $ref: '#/components/schemas/BaseMemberRemovingCoverage'
          type: array
      type: object
    MembersChangeCoverageAction:
      properties:
        adding_coverage:
          description: Details for members adding coverage
          items:
            $ref: '#/components/schemas/BaseMemberAddingCoveragePriorCoverage'
          type: array
        modifying_coverage:
          description: Details for members modifying coverage
          items:
            $ref: '#/components/schemas/BaseMemberModifyingCoverage'
          type: array
        removing_coverage:
          description: Details for members removing coverage
          items:
            $ref: '#/components/schemas/BaseMemberRemovingCoverage'
          type: array
      type: object
    ApiBaseMemberAddingCoveragePriorCoverage:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member adding coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        prior_coverage:
          allOf:
            - $ref: '#/components/schemas/BaseAddingCoveragePriorCoverage'
          description: Details about prior insurance coverage, if applicable
      required:
        - id
        - member_type
      type: object
      x-field_order:
        - id
        - member_type
        - plan_id
        - volume
        - prior_coverage
    ApiBaseMemberModifyingCoverage:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member modifying coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
      required:
        - id
        - member_type
      type: object
    BaseMemberRemovingCoverage:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member removing coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        reason:
          description: Reason the member is removing or canceling coverage
          enum:
            - other-employee-group
            - other-spouse-group
            - other-parent-group
            - other-ind-on-exchange
            - other-ind-off-exchange
            - other-cobra
            - other-medicare
            - medicaid
            - medi-cal
            - va-coverage
            - tricare-coverage
            - retiree-coverage
            - no-coverage
            - voluntary-withdrawal
          type: string
      required:
        - id
        - member_type
        - reason
      type: object
    ApiBaseMemberAddingCoveragePriorCoverageWithVolume:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member adding coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        prior_coverage:
          allOf:
            - $ref: '#/components/schemas/BaseAddingCoveragePriorCoverage'
          description: Details about prior insurance coverage, if applicable
        volume:
          description: Elected volume for the type of coverage being selected
          format: int32
          type: integer
      required:
        - id
        - member_type
      type: object
      x-field_order:
        - id
        - member_type
        - plan_id
        - volume
        - prior_coverage
    ApiBaseMemberModifyingCoverageWithVolume:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member modifying coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        volume:
          description: Elected volume for the type of coverage being selected
          format: int32
          type: integer
      required:
        - id
        - member_type
      type: object
    BaseMemberAddingCoveragePriorCoverageWithVolume:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member adding coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        prior_coverage:
          allOf:
            - $ref: '#/components/schemas/BaseAddingCoveragePriorCoverage'
          description: Details about prior insurance coverage, if applicable
        volume:
          description: Elected volume for the type of coverage being selected
          format: int32
          type: integer
      required:
        - id
        - member_type
        - plan_id
      type: object
    BaseMemberModifyingCoverageWithVolume:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member modifying coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        volume:
          description: Elected volume for the type of coverage being selected
          format: int32
          type: integer
      required:
        - id
        - member_type
        - plan_id
      type: object
    BaseMemberAddingCoveragePriorCoverage:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member adding coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
        prior_coverage:
          allOf:
            - $ref: '#/components/schemas/BaseAddingCoveragePriorCoverage'
          description: Details about prior insurance coverage, if applicable
      required:
        - id
        - member_type
        - plan_id
      type: object
    BaseMemberModifyingCoverage:
      properties:
        id:
          description: Unique identifier of the employee or dependent in Noyo
          format: uuid
          type: string
        member_type:
          description: Type of member modifying coverage
          enum:
            - dependent
            - employee
          type: string
        plan_id:
          description: Unique identifier of the group plan in Noyo
          format: uuid
          type: string
      required:
        - id
        - member_type
        - plan_id
      type: object
    BaseAddingCoveragePriorCoverage:
      properties:
        carrier_name:
          description: Name of insurance carrier providing prior coverage
          type: string
        last_coverage_date:
          description: >-
            ISO-8601 date string of the last day of coverage with the prior
            insurance carrier
          pattern: ^([0-9]{4})(-)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
          type: string
      required:
        - carrier_name
        - last_coverage_date
      type: object

````