---
title: "Create Application"
slug: "create-application"
updated: 2026-02-18T12:52:40Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/create-application"
---

> ## 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 Application

Post/v2.3/applications

This POST API will allow to create a new application. Required permissions [application:create]

SecurityHTTPType bearer

Body parameters<select class='api-response-data' aria-label='Media type'><option value='3adc4342-a39b-4dca-93f8-fc6a297056de'>application/json</option>
</select>OneOfobjectobjectnamestring    Required

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    Required

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
headersobject  Required

Application specific headers. Keys must not contain . and $

Pattern^[^.$]+$Example{
  "X-Custom-Header": "value"
}
attributesobject (HttpAttributes)  Required

HTTP Application attributes

checkStatusinteger    Default200
checkPathstring    Default""ExamplecheckPath
startRelativePathstring    Default""Pattern^$|^\/[\w\d-._~!$&'()*+,;=:@/?#%]+$Example/startRelativePath

OneOfobjectobjectusers Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

objectobjectgroups Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

objectobjectnamestring    Required

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    Required

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
headersobject  Required

Application specific headers. Keys must not contain . and $

Pattern^[^.$]+$Example{
  "X-Custom-Header": "value"
}
attributesobject  RequiredcheckStatusinteger    Default200
checkPathstring    Default""ExamplecheckPath
startRelativePathstring    Default""Pattern^$|^\/[\w\d-._~!$&'()*+,;=:@/?#%]+$Example/startRelativePath
sslCertificateVerificationboolean    Defaulttrue

OneOfobjectobjectusers Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

objectobjectgroups Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

objectobjectnamestring    Required

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    Required

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$
attributesobject (RdpAttributes)  Required

RDP Application attributes

clientTypestring    

RDP client type

Valid values[
  "web",
  "native"
]Default"web"
disableClipboardboolean    Defaultfalse
disablePrintingboolean    Defaultfalse
ignoreTLSVerificationboolean    Defaulttrue
adminConsoleboolean    Defaultfalse
maxConnectionsOneOfintegerintegerMinimum1Maximum1024Default32
integerintegerMinimum1Maximum1Default1

rdpSecurityOneOfstringstringValid values[
  "any",
  "nla",
  "nla-ext",
  "tls",
  "vmconnect",
  "rdp"
]Default"any"
stringstringValid values[
  "any"
]Default"any"

enableMultiMonitorsboolean    

authobject (ApplicationAuth)  Required

Authentication settings related to the application

authEnabledboolean    Required
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

OneOfobjectobjectusers Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

groups Array of string (AlphanumericWithSpace)   

List of IDs of assigned groups. To get the IDs use endpoint '/groups' with [group:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

objectobjectgroups Array  Required
namestring    

Application name

Min length5Max length32Pattern^[^~`()!#$%^&*+=[]\';,/{}|":<>?№@]+$ExampleMyApplication
typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp"
]
networkExampleZwAeo5wqiF
hostOneOfFixedHostobject (FixedHost)sourcestring    Required

Application host source

Valid values[
  "fixed"
]
valueOneOf

IdpHostobject (IdpHost)sourcestring    Required

Application host source

Valid values[
  "idp"
]
valuestring    Required

Application host value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

portOneOfFixedPortobject (FixedPort)sourcestring    Required

Application port source

Valid values[
  "fixed"
]
valueExample443

IdpPortobject (IdpPort)sourcestring    Required

Application port source

Valid values[
  "idp"
]
valuestring    Required

Application port value

Pattern^[a-zA-Z0-9_.-]{2,255}$ExampleidpExample

users Array of string (AlphanumericWithSpace)   

List of IDs of assigned users. To get the IDs use endpoint '/users' with [user:read] permission.

Min items1Example[
  "mWKM26JMc1",
  "mWKM26JMc2"
]string    

Any alphanumeric value with space

Min length1Pattern^[a-zA-Z0-9 ]+$

Responses202

Application created successfully

<select class='api-response-data' aria-label='Media type'><option value='d0fdc8cd-01ee-4906-b504-dd56e8febac5'>application/json</option>
</select>object  statusUrlstring    
samplingTimeinteger    

400

Bad Request

401

Not Authorized

403

Forbidden

500

Internal Server Error