Create Group

Restriction: This API endpoint is not supported in the Free Trial cloud.

Creates a new org group.

Important: To be able to run this API endpoint, you need to be an Admin user.

URL

Copy
http://<your-cloud>.app.perfectomobile.com/api/v1/org-groups

Method

POST

Header parameters

Name

Description

Perfecto-Authorization

Security Token

Data parameters (body)

Parameter

Type Default

Description

name* string

The name of the org group being created. Cannot exceed 200 characters.

description string

A description for the org group being added. Cannot exceed 512 characters.

* Mandatory parameter

Example

Copy
JSON request
{
    "name":"adminGroup", 
    "description":"admin rights"
}
Copy
JSON success response
{
    "key": "adminGroup_15840",
    "name": "adminGroup",
    "description": "admin rights"
}

Error response

Status and a generic error message