Disconnecting a Group

Tell Noyo to stop exchanging data for a group

Groups may need to be disconnected from Noyo for a few different reasons:

  • The group is no longer your customer and has moved to a different ben-admin solution
  • The group has not renewed coverage with the carrier
  • The group is no longer eligible for coverage with the carrier


Disconnecting groups properly prevents incorrect billing and manual cleanup work to fix erroneous enrollments.

Group disconnection requests

Similar to Group Connection Requests, you must tell Noyo when a group needs to be disconnected from our system. On the date specified in the request, we will stop pulling the group's data from the carrier and will stop accepting new enrollment changes.

There are some instances where communications or automated responses from the carrier indicate that a group should be disconnected. When this happens, we will create a disconnection request that someone on your team must confirm or reject. Disconnection requests can be managed over API or in the Command Center.

Sending a group disconnection request

First, create the request and populate it with the relevant carrier_id, effective_end_date, and group_id. The effective_end_date is the last day that coverage should be managed through Noyo. When we receive the request we will process it and it will move through the statuses listed below.

If the request is rejected, it may be because of an invalid ID or end date. Edit the request to submit new or corrected data.

Disconnection request statuses

Group disconnections will move through several different statuses as they pass through Noyo’s system and are processed with carriers.

needs_reviewThe group disconnection is awaiting your confirmation or rejection.
processingNoyo is working on disconnecting the group from the carrier.
completedThe group has been disconnected from the carrier.
rejectedThe group disconnection request has been rejected. The group will remain connected to the carrier.

Managing disconnection requests

Poll the Noyo API to discover whether there are requests that need your attention. We recommend doing this weekly. You can also set up recurring checks for each group using our endpoint that polls for disconnection requests for a specific group.

You can use our endpoints to build an internal tool for your team to review, confirm, or reject disconnection requests.

In the Command Center

You can also manage disconnection requests in the Command Center. Visit the Disconnecting page under Groups in the sidebar. From there, you can check the status of your disconnection requests and give us input on whether certain groups should be disconnected; we'll surface these groups based on responses we receive from carriers.

To initiate a disconnection request in the Command Center, visit the group's detail page and select a carrier connection from the sidebar. From there you can request to disconnect the group from that carrier.

What’s Next

Connect a new group to Noyo