---
title: "Create a new Wireguard tunnel"
slug: "create-a-new-wireguard-tunnel"
updated: 2026-02-18T12:52:40Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/create-a-new-wireguard-tunnel"
---

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

# Create a new Wireguard tunnel

Post/v2.3/networks/{networkId}/tunnels/wireguard

Required permissions: `["network:write"]`

SecurityHTTPType bearer

Path parametersnetworkIdstringRequired

Body parameters<select class='api-response-data' aria-label='Media type'><option value='75c78b95-ca80-4765-8529-3bbea860ebee'>application/json</option>
</select>object  remoteEndpointstring  (ipv4)    Required
remoteSubnets Array of string   RequiredMin length1string    
regionIDstring    Required

Region ID

gatewayIDstring    Required

Gateway ID

tunnelNamestring    Required

The name of the tunnel

Min length3Max length15Pattern^[a-zA-Z0-9]*$

Responses202

Request accepted

<select class='api-response-data' aria-label='Media type'><option value='c8065331-a797-44fd-81e4-eddc52417824'>application/json</option>
</select>object  statusUrlstring    
samplingTimeinteger    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='62e29267-736b-447f-9b1b-024b84523ea4'>application/json</option>
</select>object  idstring    
messagestring    

402

Insufficient licenses

<select class='api-response-data' aria-label='Media type'><option value='cef26cf5-027e-4c5d-afc8-3f5a1ccf0c09'>application/json</option>
</select>object  idstring    
messagestring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='b6dc37d8-45e6-4d33-a71d-4afe9abac093'>application/json</option>
</select>object  idstring    
messagestring    

404

Resource not found

<select class='api-response-data' aria-label='Media type'><option value='465d5e2e-4a14-4a44-8b79-3273772635e6'>application/json</option>
</select>object  idstring    
messagestring    

422

Unprocessable entity

<select class='api-response-data' aria-label='Media type'><option value='a2601f9d-40c9-476c-83a0-16e98d3fe749'>application/json</option>
</select>object  idstring    
messagestring