Add Client: add_client
Service name: add_client |
|
URL |
https://SERVER/api/?apikey=yourAPItoken&service=add_client &required_parameters=required_parameters [&optional_parameters=optional_parameters] |
Description |
Creates a new client, must at least provide a name |
Parameters |
|||||
Post Variable |
Description |
Type |
Required |
Options |
Default |
describe |
Optional. Returns a description of the service. |
boolean |
no |
true |
0 |
name |
The name of the client |
string |
yes |
||
Timezone if different to company, e.g. Europe/Madrid The following section contains a list of the currently available timezones |
string |
no |
0 |
0 |
|
licenseconfig |
Xml license config, see documentation for details. |
xml |
no |
0 |
0 |
reportconfig |
Xml report config, see documentation for details |
xml |
no |
0 |
0 |
officehoursemail |
Valid email address for office hours alert routing emails |
|
no |
0 |
0 |
officehourssms |
Valid phone number for office hours alert routing sms |
phone |
no |
0 |
0 |
outofofficehoursemail |
Valid email address for out of office hours alert routing emails |
|
no |
0 |
0 |
outofofficehourssms |
Valid phone number for out of office hours alert routing sms |
phone |
no |
0 |
0 |
Example parameter configuration example for reportconfig |
<reportconfig> <report> <type>server_daily</type> <mailto>test@test.com</mailto> <mailcc>testcc@test.com</mailcc> <sendat>6:00</sendat> </report> <report> <type>workstation_daily</type> <mailto>test@test.com</mailto> <mailcc>testcc@test.com</mailcc> <sendat>6:00</sendat> <daystorun>mon,wed,fri</daystorun> </report> </reportconfig> |
Example parameter configuration example for licenseconfig (groupid = license_group_id from list_license_group_items) |
<licenseconfig> <license> <groupid>1</groupid> <count>1</count> </license> <license> <groupid>2</groupid> <count>22</count> </license> <license> <groupid>3</groupid> <count>22</count> </license> <license> <groupid>4</groupid> <count>5</count> </license> <license> <groupid>5</groupid> <count>51</count> </license> </licenseconfig> |
Example Service Call =add_client |
https://SERVER/api/?apikey=yourAPItoken&service=add_client&name=NEW CLIENT& |
Example Response: Server |
<?xml version="1.0"?> <result> <data> <success>1</success> <clientid>1694</clientid> </data> </result> |
Example Response: Error |
<result> <error> <message>Duplicate name</message> </error> </result> |
Field Descriptions |
|||
Field |
Type |
Can Be Empty |
Description |
success |
integer |
no |
Creation of new client has succeeded (1) or not (0) |
clientid |
integer |
no |
Id of new client created |