Create and manage Networks

A Network connects the user’s dedicated Telnyx resources to the networks the user runs outside Telnyx. Each Network has its own routes and is isolated from every other Network.

Create a Network

Send a name for the Network:

POST /v2/networks

{
  "name": "acme-prod"
}

The response contains the stable Network ID:

{
  "data": {
    "name": "acme-prod",
    "created_at": "2026-10-12T18:00:54.022171Z",
    "updated_at": "2026-10-12T18:00:54.022171Z",
    "id": "264fe95b-73a8-4a26-a979-2d875e934f4e",
    "record_type": "network"
  }
}

Store data.id. Attachment APIs use this UUID as their network_id.

List and retrieve Networks

List the Networks associated with the account:

GET /v2/networks

Retrieve one Network by ID:

GET /v2/networks/{id}

Use filter[name] with the list operation to find a Network by name.

Rename a Network

Renaming a Network does not change its ID or its attachments:

PATCH /v2/networks/{id}

{
  "name": "acme-production"
}

Inspect attached interfaces

List the interfaces attached to a Network:

GET /v2/networks/{id}/network_interfaces

Filter the result by name, type, or status. WireGuard Interfaces have the type cloud_vpn, and Tailscale Subnet Routers tailscale_subnet_router:

GET /v2/networks/{id}/network_interfaces?filter[type]=cloud_vpn

{
  "data": [
    {
      "name": "acme-prod-wg",
      "status": "provisioning",
      "created_at": "2026-10-12T18:00:54.274991Z",
      "region_code": "ashburn-va",
      "id": "df98c084-da39-4dd3-9134-da38d1990eec",
      "updated_at": "2026-10-12T18:00:56.362170Z",
      "network_id": "264fe95b-73a8-4a26-a979-2d875e934f4e",
      "type": "cloud_vpn",
      "region": {
        "code": "ashburn-va",
        "name": "Ashburn VA, US",
        "record_type": "region"
      },
      "record_type": "network_interface"
    }
  ],
  "meta": {
    "total_pages": 1,
    "total_results": 1,
    "page_number": 1,
    "page_size": 25
  }
}

Delete a Network

Delete the Network’s interfaces first. A Network that still has interfaces returns 409 with error code 10021, Resource in use. Then delete the Network by ID:

DELETE /v2/networks/{id}

​Create a Network

​List and retrieve Networks

​Rename a Network

​Inspect attached interfaces

​Delete a Network

Create a Network

List and retrieve Networks

Rename a Network

Inspect attached interfaces

Delete a Network