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

# SIM Card Groups

> Apply group-level configuration and policy to Telnyx IoT SIM cards, including data limits, allowed networks, and security settings managed in bulk.

<Warning>
  **Groups vs Bulk Operations** — Groups are ongoing policy; a SIM inherits its group's settings as long as it's a member. Bulk operations are one-time actions on an explicit list of SIMs.
</Warning>

Every SIM belongs to a group and inherits its settings. Set policy on the group instead of updating SIMs individually.

## Default Group

Every account has a default group. SIMs that aren't explicitly assigned land here. Deleting a group moves its SIMs back to default. Moving SIMs between groups after they're active can briefly interrupt connectivity.

## Group Settings

Configurable via [`PATCH /sim_card_groups/{id}`](/api-reference/sim-card-groups/update-a-sim-card-group):

| Setting      | Description                                                                                                                          |
| :----------- | :----------------------------------------------------------------------------------------------------------------------------------- |
| `name`       | Display name for the group.                                                                                                          |
| `data_limit` | Data cap (`amount` + `unit`). SIMs exceeding this enter `data_limit_exceeded` until the limit is raised or the billing cycle resets. |

## Group Actions

These are async — each returns an action ID. Track progress via [`GET /sim_card_group_actions`](/api-reference/sim-card-group-actions/list-sim-card-group-actions).

| Action                                                                                                                           |
| :------------------------------------------------------------------------------------------------------------------------------- |
| [Assign Private Wireless Gateway](/api-reference/sim-card-groups/request-private-wireless-gateway-assignment-for-sim-card-group) |
| [Remove Private Wireless Gateway](/api-reference/sim-card-groups/request-private-wireless-gateway-removal-from-sim-card-group)   |
| [Assign Wireless Blocklist](/api-reference/sim-card-groups/request-wireless-blocklist-assignment-for-sim-card-group)             |
| [Remove Wireless Blocklist](/api-reference/sim-card-groups/request-wireless-blocklist-removal-from-sim-card-group)               |