---
title: "Create a SIM card group"
method: POST
path: "/sim_card_groups"
tags: ["SIM Card Groups"]
---

# Create a SIM card group

`POST /sim_card_groups`

Creates a new SIM card group object

## Request body

- SIMCardGroupCreate
  - `name` string, required — A user friendly name for the SIM card group.
  - `data_limit` object — Upper limit on the amount of data the SIM cards, within the group, can use.
    - `amount` string
    - `unit` string

## Response `200`

Successful Response

- object
  - `data` SIMCardGroup
    - `id` string, uuid — Identifies the resource.
    - `record_type` string — Identifies the type of the resource.
    - `default` boolean — Indicates whether the SIM card group is the users default group.<br/>The default group is created for the user and can not be removed.
    - `name` string — A user friendly name for the SIM card group.
    - `data_limit` object — Upper limit on the amount of data the SIM cards, within the group, can use.
      - `amount` string
      - `unit` string
    - `consumed_data` ConsumedData — Represents the amount of data consumed.
      - `unit` string
      - `amount` string
    - `private_wireless_gateway_id` string, uuid — The identification of the related Private Wireless Gateway resource.
    - `wireless_blocklist_id` string, uuid — The identification of the related Wireless Blocklist resource.
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.

## Other responses

- `401` — Unauthorized
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)