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

> ## 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/standard/{networkId}/tunnels/wireguard

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

SecurityHTTPType bearer

Path parametersnetworkIdstringRequired

Body parameters<select class='api-response-data' aria-label='Media type'><option value='d2acfb0c-1ddf-40c1-b813-c520d25ffac3'>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='66b4adcc-b92a-45a9-b9ad-4ba13a9b7181'>application/json</option>
</select>object  statusUrlstring    
samplingTimeinteger    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='295dedf2-0f32-40de-a506-d95fc7f9ab2d'>application/json</option>
</select>object  idstring    
messagestring    

402

Insufficient licenses

<select class='api-response-data' aria-label='Media type'><option value='e630cfbf-6fa9-4c66-964e-f46b5f25a828'>application/json</option>
</select>object  idstring    
messagestring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='f0b8f41c-1d6e-490e-8ce4-9da01caee871'>application/json</option>
</select>object  idstring    
messagestring    

404

Resource not found

<select class='api-response-data' aria-label='Media type'><option value='21efa8fe-b5ce-4ea9-a46b-7bbac13fe095'>application/json</option>
</select>object  idstring    
messagestring    

422

Unprocessable entity

<select class='api-response-data' aria-label='Media type'><option value='83651049-4221-4c96-b9d3-baa89f5a69fb'>application/json</option>
</select>object  idstring    
messagestring