> ## 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.

# Blue Cross Blue Shield of Massachusetts

> Technical documentation for integrating with BCBS Massachusetts through Noyo

| | |
| - | - |
| **API** | Snapshot |
| **COBRA** | Supported |
| **Geographies** | All |
| **Group Size** | At least 150 subscribed employees |
| **Lines** | Dental, medical, vision |
| **Name** | BlueCross BlueShield of Massachusetts |
| **Network** | Send |
| **New Group Connection Time** | 6–8 weeks |
| **Carrier ID** | `9b71b802-1074-40b4-8b6f-82bdadb8ff92` |

## Group connections

[Create a group connection request](https://docs.noyo.com/docs/groups/connections/request-a-group-connection.md#connecting-groups-to-send-carriers) to manage groups through Noyo. In the `group_data` object for the create endpoint, use BCBS MA group ID (also called the master agreement number) for the `carrier_group_id`. The format expected is a 7-digit numeric string.

### Sandbox testing

Use the following special BCBS Massachusetts `carrier_group_id`s to simulate different group connection statuses. Test group connections with these IDs will asynchronously update with the corresponding status within 10 seconds of submission.

Only the first three characters are evaluated to figure out the target status (e.g. 989 means `noyo_review`). Since group connections should be unique by a carrier ID and carrier group ID combination, you may use the final characters to iterate and test this interaction further.

| Test ID Pattern | Resulting Status |
| - | - |
| 989\*\*\* | `noyo_review` |
| 767\*\*\* | `waiting_on_carrier` |
| 545\*\*\* | `action_required` |
| 323\*\*\* | `unable_to_connect` |
| 212\*\*\* | `move_to_carrier_authorization` |

## Carrier configurations

> [!WARNING]
>
> [Dynamic config](https://docs.noyo.com/docs/groups/mapping/explicit-vs-dynamic-configuration.md#dynamic-config-automap) is recommended for all new Noyo integrations and makes carrier-specific config values no longer required.

Group, plan, and member configurations are where Noyo shares and receives details that are **unique** to a carrier. Every other part of Noyo's payloads are standardized, but the configurations hold the unique fields and classifications that change from connection to connection. As part of preparing to connect to a new carrier, you need to understand the contents of each configuration and be sure your system is able to send the required data for each member.

### Get the group configuration from Noyo

*The [Get carrier configuration by group list](https://docs.noyo.com/api-reference/groups/configurations/get-carrier-configuration-by-group-list.md) returns information about how the group is labeled and categorized within the carrier's system. You can also see this data in the Command Center on a group's detail page by clicking one of their carrier connections.*

BCBS MA groups will be configured with a `master_agreement_number` string, which is the primary group identifier, along with a list of one or more `groups` (7 digit numeric code) to categorize employees enrolling in coverage.

```json theme={"system"}
{
    "group_id": "da8d32cc-ce9d-4cf3-9360-733ee0023f1f",
    "carrier_id": "9b71b802-1074-40b4-8b6f-82bdadb8ff92",
    "configuration": {
        "master_agreement_number": "12345678",
        "groups": [
            {
                "group_identifier": "001234567",
                "group_name": "AcmeCo Active"
            },
            {
                "group_identifier": "003456789",
                "group_name": "AcmeCo COBRA"
            }
        ]
    }
}
```

### Get the plan configuration from Noyo

*The details in [Get group plan list](https://docs.noyo.com/api-reference/groups/plans/get-group-plan-list.md) should be used to [map each Noyo plan to the corresponding plan in your own system](https://docs.noyo.com/docs/groups/mapping/mapping-plans-and-account-structures.md). Importantly, each plan configuration has details about which populations are connected to an individual plan. Groups with multiple populations may link a plan with one or more of them.*

Some BCBS MA plans are only available for employees in certain groups. BCBS MA plans will include a `plan_configuration` \*\*\*\*block with \`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.