---
title: "Create a new IPSec Single tunnel"
slug: "create-a-new-ipsec-single-tunnel-3"
updated: 2026-02-18T12:52:40Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/create-a-new-ipsec-single-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 IPSec Single tunnel

Post/v2.3/networks/standard/{networkId}/tunnels/ipsec/single

Required permissions: `["network:write]`

SecurityHTTPType bearer

Path parametersnetworkIdstringRequired

Body parameters<select class='api-response-data' aria-label='Media type'><option value='78bb3b76-37c6-4701-bea5-ffce59a44cae'>application/json</option>
</select>object  regionIDstring    Required

Region ID

gatewayIDstring    Required

Gateway ID

tunnelNamestring    Required

The name of the tunnel

Min length3Max length15Pattern^[a-zA-Z0-9]*$
p81GatewaySubnets Array of string   RequiredMin length1string    
remoteGatewaySubnets Array of string   RequiredMin length1string    
peakBandwidthinteger    

Expected peak throughput of the tunnel communication in Mbps. Typical connection will be of 1000Mbps.

Minimum10Maximum8000Default1000
p81ASNinteger #deprecatedtemplate# #additional-property-template#OneOfintegerintegerMinimum1Maximum23455
integerintegerMinimum23457Maximum64495
integerintegerMinimum64512Maximum65534
integerintegerMinimum131072Maximum4294967294

featuresobject  symmetricInnerMeshobject  enabledboolean    Defaultfalse

keyExchangestring    RequiredValid values[
  "ikev1",
  "ikev2"
]
ikeLifeTimestring    RequiredPattern^((1[0-9]|[2-9][0-9]|[1-9][0-9]{2,3}|[1-7][0-9]{4}|8[0-5][0-9]{3}|86[0-3][0-9]{2}|86400)s)|(([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|1[0-3][0-9][0-9]|14[0-3][0-9]|1440)m)|(([1-9]|1[0-9]|2[0-4])h)$
lifetimestring    RequiredPattern^((1[0-9]|[2-9][0-9]|[1-9][0-9]{2,3}|[1-7][0-9]{4}|8[0-5][0-9]{3}|86[0-3][0-9]{2}|86400)s)|(([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|1[0-3][0-9][0-9]|14[0-3][0-9]|1440)m)|(([1-9]|1[0-9]|2[0-4])h)$
dpdDelaystring    RequiredPattern^([5-9]|[1-5][0-9]|60)s$
dpdTimeoutstring    RequiredPattern^([5-9]|[1-5][0-9]|60)s$
phase1object  Requiredauth Array of string   Min length1string    Valid values[
  "md5",
  "sha1",
  "sha384",
  "sha256",
  "sha512",
  "aesxcbc",
  "aescmac",
  "prfmd5",
  "prfsha1",
  "prfaesxcbc",
  "prfaescmac",
  "prfsha256",
  "prfsha384",
  "prfsha512"
]
encryption Array of string   Min length1string    Valid values[
  "3des",
  "blowfish128",
  "blowfish192",
  "blowfish256",
  "aes128",
  "aes192",
  "aes256",
  "aes128ctr",
  "aes192ctr",
  "aes256ctr",
  "camellia128",
  "camellia192",
  "camellia256",
  "camellia128ctr",
  "camellia192ctr",
  "camellia256ctr",
  "aes128ccm8",
  "aes192ccm8",
  "aes256ccm8",
  "aes128ccm16",
  "aes192ccm16",
  "aes256ccm16",
  "aes128gcm8",
  "aes192gcm8",
  "aes256gcm8",
  "aes128gcm16",
  "aes192gcm16",
  "aes256gcm16",
  "camellia128ccm16",
  "camellia192ccm16",
  "camellia256ccm16",
  "chacha20poly1305"
]
dh Array of integer   Required

Diffie Helman encryption

Min length0integer    Valid values[
  2,
  5,
  14,
  19,
  20,
  21,
  31
]

phase2object  Requiredauth Array of string   Min length1string    Valid values[
  "md5",
  "sha1",
  "sha384",
  "sha256",
  "sha512",
  "aesxcbc",
  "aescmac",
  "prfmd5",
  "prfsha1",
  "prfaesxcbc",
  "prfaescmac",
  "prfsha256",
  "prfsha384",
  "prfsha512"
]
encryption Array of string   Min length1string    Valid values[
  "3des",
  "blowfish128",
  "blowfish192",
  "blowfish256",
  "aes128",
  "aes192",
  "aes256",
  "aes128ctr",
  "aes192ctr",
  "aes256ctr",
  "camellia128",
  "camellia192",
  "camellia256",
  "camellia128ctr",
  "camellia192ctr",
  "camellia256ctr",
  "aes128ccm8",
  "aes192ccm8",
  "aes256ccm8",
  "aes128ccm16",
  "aes192ccm16",
  "aes256ccm16",
  "aes128gcm8",
  "aes192gcm8",
  "aes256gcm8",
  "aes128gcm16",
  "aes192gcm16",
  "aes256gcm16",
  "camellia128ccm16",
  "camellia192ccm16",
  "camellia256ccm16",
  "chacha20poly1305"
]
dh Array of integer   Required

Diffie Helman encryption

Min length0integer    Valid values[
  2,
  5,
  14,
  19,
  20,
  21,
  31
]

passphrasestring    Pattern^[a-zA-Z1-9._][a-zA-Z0-9._]{7,63}$
remotePublicIPstring  (ipv4)    
remoteIDOneOfstring (ipv4)string
stringstringPattern^[a-zA-Z0-9]{3,25}$

Responses202

Request accepted

<select class='api-response-data' aria-label='Media type'><option value='b0e68b4c-d6a7-45b6-97c7-558f367e4989'>application/json</option>
</select>object  statusUrlstring    
samplingTimeinteger    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='314362f9-1e48-4876-a158-778f22388280'>application/json</option>
</select>object  idstring    
messagestring    

402

Insufficient licenses

<select class='api-response-data' aria-label='Media type'><option value='871ae4c7-229d-4d09-ae09-d220364e75e3'>application/json</option>
</select>object  idstring    
messagestring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='614b53a9-3cd5-444e-b749-30025b83b23d'>application/json</option>
</select>object  idstring    
messagestring    

404

Resource not found

<select class='api-response-data' aria-label='Media type'><option value='dd77ab9b-c735-461c-bc28-b0106b585e20'>application/json</option>
</select>object  idstring    
messagestring    

422

Unprocessable entity

<select class='api-response-data' aria-label='Media type'><option value='390d2aa1-7f9a-4cd5-8ad5-16a779b962db'>application/json</option>
</select>object  idstring    
messagestring