We recommend creating groups in Noyo as soon as they are known to your ben-admin system. Then you can start sending member snapshots to Noyo to establish their data in our system; we use this data to calculate the group’s eligibility for different types of carrier connections and write account structure mapping rules.

To create a group in Noyo, use the Create Group endpoint. This endpoint allows you to create a new group in our system with a small amount of information.

Once the group is created, you can begin sending snapshots for the group’s members. Noyo will store this data but not send anything along to carriers just yet; instead, we’ll use the employee data to calculate the group’s eligibility for different types of carrier connections and eventually write mapping rules if needed.

Older integrations that do not use Noyo’s dynamic configuration and mapping features generally start their workflow with the group connection request, which creates the group synchronously.

​
The group lifecycle with Noyo

After you create a group and populate it with employee records, you can choose when to activate data exchange through Noyo by connecting the group (covered in the next section). Here’s a simplified view of the group lifecycle on Noyo: