---
title: "Create a Private Wireless Gateway"
method: POST
path: "/private_wireless_gateways"
tags: ["Private Wireless Gateways"]
---

# Create a Private Wireless Gateway

`POST /private_wireless_gateways`

Asynchronously create a Private Wireless Gateway for SIM cards for a previously created network. This operation may take several minutes so you can check the Private Wireless Gateway status at the section Get a Private Wireless Gateway.

## Request body

- object
  - `network_id` string, uuid, required — The identification of the related network resource.
  - `name` string, required — The private wireless gateway name.
  - `region_code` string — The code of the region where the private wireless gateway will be assigned. A list of available regions can be found at the regions endpoint

## Response `202`

Successful Response

- object
  - `data` PrivateWirelessGateway
    - `id` string, uuid — Identifies the resource.
    - `network_id` string, uuid — The identification of the related network resource.
    - `record_type` string
    - `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.
    - `name` string — The private wireless gateway name.
    - `region_code` string — The name of the region where the Private Wireless Gateway is deployed.
    - `status` PrivateWirelessGatewayStatus — The current status or failure details of the Private Wireless Gateway.
      - `value` 'provisioning' | 'provisioned' | 'failed' | 'decommissioning' — The current status or failure details of the Private Wireless Gateway. <ul> <li><code>provisioning</code> - the Private Wireless Gateway is being provisioned.</li> <li><code>provisioned</code> - the Private Wireless Gateway was provisioned and able to receive connections.</li> <li><code>failed</code> - the provisioning had failed for a reason and it requires an intervention.</li> <li><code>decommissioning</code> - the Private Wireless Gateway is being removed from the network.</li> </ul> Transitioning between the provisioning and provisioned states may take some time.
      - `error_description` string, nullable — This attribute provides a human-readable explanation of why a failure happened.
      - `error_code` string, nullable — This attribute is an [error code](https://developers.telnyx.com/development/api-fundamentals/api-errors) related to the failure reason.
    - `ip_range` string — IP block used to assign IPs to the SIM cards in the Private Wireless Gateway.
    - `assigned_resources` PWGAssignedResourcesSummary[] — A list of the resources that have been assigned to the Private Wireless Gateway.
      - `record_type` string — The type of the resource assigned to the Private Wireless Gateway.
      - `count` integer — The current count of a resource type assigned to the Private Wireless Gateway.

## Other responses

- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `default` — Unexpected error

---

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