Create a New Group

post

https://{account}.sysaidit.com/connect/v1/groups

Creates a new user group in your SysAid account.

Body Params

name

string

required

length ≤ 64

The group's name.

type

string

enum

required

The group type. The group permissions will be set according to the indicated type.

Allowed:

supportLevel

integer

Support level indicates in what order a service record moves through your support structure.
For example, all service records might go to 1st level. Difficult service records that 1st level can't solve would be passed on to 2nd level, and only special cases might be advanced from 2nd level to 3rd level.
The support level of an Agent in more than one group is the highest support level of any of the groups he is in. Only relevant for Admin type groups.
The support level determines the permissions and access rights associated with the group.
The default value is 3.

companyId

integer | null

Unique ID of the company the groups works for.

string

length ≤ 256

The email address associated with the group.

receiveAutomaticSrEmailNotifications

boolean

Indicates whether the group receives automatic service record email notifications when the record is updated.

canBeAssignedToServiceRecord

boolean

Indicates if the group can be assigned to a service record. Not applicable if the group type is set to end-users.

enableAutomaticDispatchOfServiceRecords

boolean

Determines if service records should be automatically dispatched. Only applicable if the canBeAssignedToServiceRecord is set to true.

Responses

201Group created successfully

400The request was invalid or cannot be served

401Authentication information is missing or invalid

409The request could not be completed due to a conflict with the current state of the resource. This typically occurs when attempting to create a duplicate resource, update a resource that has been modified by another process, or when business rules prevent the operation.