> For the complete documentation index, see [llms.txt](https://ideonapi.gitbook.io/enrollment/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/qualifying-life-events/events.md). # Events A guide to using different events and how they relate to the existing event types in your system. Platform systems can already have an enumeration of values that they consider to be "Change Events" or "Life Events". Use the following definitions to help map existing values to the Ideon enum of values: | Ideon Event | Description | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | birth |

Used when adding a newborn's coverage within 30 days.

Note: If adding a new dependent mid-year, during OE, or a few months after a birth, use the newly\_eligible event.

| | cobra |

For COBRA elections. Used in conjunction with the plan\_elections.status to elect COBRA continuation after a termination.

Due to the nature of COBRA coverages, dependents can elect coverage without an active subscriber using this event type.

| | divorce |

Used when a divorce event results in ending coverages for some or all non-employee covered members.

Common use-case: This event can precede a COBRA event for the individual dependent.

| | initial\_enrollment | An event type for the initial load of data to Ideon, or for sending Ideon historical elections that were the "initial" elections. | | loss\_of\_coverage |

Used when a dependent is added or removed to changes in other coverages that cannot be duplicated.

This can be used if a member was previously covered under their own plan but is now moving to their subscriber's plan, etc.

| | marriage | This event type can be used to add dependent(s) to a given subscriber/elected family. | | new\_hire |

Used when a new employee is hired and elects initial benefits.

The event date must match that of the employee's employment\_start\_date

| | newly\_eligible |

Used as a general event type.
This can be used when a member becomes eligible after a waiting period, or changes coverages for any other reason.


If another event code cannot be resolved by your system, default to newly\_eligible.

| | open\_enrollment | This event type can be used for a new plan year's elections. | | termination\_of\_employment | Used to indicate when an employee is no longer with the company and thus, terminates employment and supplies `end_date`s for all plan elections. | | re\_hire | If this cannot be detected, or the member was not managed in the same system during their previous employment, `new_hire` or `newly_eligible` can be used. | [^1]: