POST api/Users

Create User

Request Information

URI Parameters

None.

Body Parameters

The user being created

Name	Description	Type	Additional information
ClientID	The client ID	integer	None.
UserName	The user name	string	None.
Password	The password	string	None.
Email	The email address	string	None.
GivenName	The given name	string	None.
FamilyName	The family name	string	None.
UserRole	The User Role	UserRole	None.
MobileNumber	The user's mobile phone number	string	None.
TimeZoneID	ID of the user's TimeZone	string	None.
EnableAlertTimeframe	Whether or not this user has a set timeframe for receiving alerts	boolean	None.
AlertTimeframeStart	The start of the user's Alert Timeframe	time interval	None.
AlertTimeframeEnd	The end of the user's Alert Timeframe	time interval	None.
DefaultDashboard	The User's default dashboard, for the WebApp	integer	None.
DateFormat	Format string for displaying Date information	string	None.
TimeFormat	Format string for displaying Time information	string	None.
GraphTooltips	Whether or not to display tooltips on MultiGraphs	boolean	None.

Request Formats

application/json, text/json, text/html

Sample:

{
  "ClientID": 1,
  "UserName": "sample string 2",
  "Password": "sample string 3",
  "Email": "sample string 4",
  "GivenName": "sample string 5",
  "FamilyName": "sample string 6",
  "UserRole": 0,
  "MobileNumber": "sample string 7",
  "TimeZoneID": "sample string 8",
  "EnableAlertTimeframe": true,
  "AlertTimeframeStart": "00:00:00.1234567",
  "AlertTimeframeEnd": "00:00:00.1234567",
  "DefaultDashboard": 1,
  "DateFormat": "sample string 9",
  "TimeFormat": "sample string 10",
  "GraphTooltips": true
}

application/xml, text/xml

Sample:

<APIStructs.Add_User xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RimikAPI.Models">
  <AlertTimeframeEnd>PT0.1234567S</AlertTimeframeEnd>
  <AlertTimeframeStart>PT0.1234567S</AlertTimeframeStart>
  <ClientID>1</ClientID>
  <DateFormat>sample string 9</DateFormat>
  <DefaultDashboard>1</DefaultDashboard>
  <Email>sample string 4</Email>
  <EnableAlertTimeframe>true</EnableAlertTimeframe>
  <FamilyName>sample string 6</FamilyName>
  <GivenName>sample string 5</GivenName>
  <GraphTooltips>true</GraphTooltips>
  <MobileNumber>sample string 7</MobileNumber>
  <Password>sample string 3</Password>
  <TimeFormat>sample string 10</TimeFormat>
  <TimeZoneID>sample string 8</TimeZoneID>
  <UserName>sample string 2</UserName>
  <UserRole>Monitor</UserRole>
</APIStructs.Add_User>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

A user response

GetUsersResponse

Name	Description	Type	Additional information
Users	Array of users	Collection of UserStruct	None.
Messages	Array of messages	Collection of Message	None.
ServerInformation	Relevant information regarding the Server	ServerInformation	None.
VersionInformation	Relevant information regarding the API's version	VersionInformation	None.

Response Formats

application/json, text/json, text/html

Sample:

{
  "Users": [
    {
      "ID": 1,
      "ClientID": 2,
      "UserName": "sample string 3",
      "GivenName": "sample string 4",
      "FamilyName": "sample string 5",
      "Email": "sample string 6",
      "UserRole": 0,
      "UserRoleDescription": "sample string 7",
      "MobileNumber": "sample string 8",
      "TimeZoneID": "sample string 9",
      "EnableAlertTimeframe": true,
      "AlertTimeframeStart": "00:00:00.1234567",
      "AlertTimeframeEnd": "00:00:00.1234567",
      "DefaultDashboard": 13,
      "DateFormat": "sample string 14",
      "TimeFormat": "sample string 15",
      "GraphTooltips": true
    },
    {
      "ID": 1,
      "ClientID": 2,
      "UserName": "sample string 3",
      "GivenName": "sample string 4",
      "FamilyName": "sample string 5",
      "Email": "sample string 6",
      "UserRole": 0,
      "UserRoleDescription": "sample string 7",
      "MobileNumber": "sample string 8",
      "TimeZoneID": "sample string 9",
      "EnableAlertTimeframe": true,
      "AlertTimeframeStart": "00:00:00.1234567",
      "AlertTimeframeEnd": "00:00:00.1234567",
      "DefaultDashboard": 13,
      "DateFormat": "sample string 14",
      "TimeFormat": "sample string 15",
      "GraphTooltips": true
    }
  ],
  "Messages": [
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    },
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    }
  ],
  "ServerInformation": {
    "CurrentTimeUTC": "2025-11-09T21:27:05.6968153+10:00",
    "BuildDateUTC": "2025-11-09T21:27:05.6968153+10:00"
  },
  "VersionInformation": {
    "Major": 1,
    "Minor": 3,
    "Hotfix": 7,
    "Beta": false,
    "Version": "1.3.7"
  }
}

application/xml, text/xml

Sample:

<GetUsersResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/RimikAPI.Models.Responses">
  <Messages xmlns:d2p1="http://schemas.datacontract.org/2004/07/RimikAPI.Services">
    <d2p1:Common.Message>
      <d2p1:CodeDesc>2</d2p1:CodeDesc>
      <d2p1:MessageCode>1</d2p1:MessageCode>
      <d2p1:MessageText>sample string 3</d2p1:MessageText>
      <d2p1:RecordNumber>4</d2p1:RecordNumber>
      <d2p1:Severity>Information</d2p1:Severity>
    </d2p1:Common.Message>
    <d2p1:Common.Message>
      <d2p1:CodeDesc>2</d2p1:CodeDesc>
      <d2p1:MessageCode>1</d2p1:MessageCode>
      <d2p1:MessageText>sample string 3</d2p1:MessageText>
      <d2p1:RecordNumber>4</d2p1:RecordNumber>
      <d2p1:Severity>Information</d2p1:Severity>
    </d2p1:Common.Message>
  </Messages>
  <ServerInformation xmlns:d2p1="http://schemas.datacontract.org/2004/07/RimikAPI.Services.Metadata">
    <d2p1:BuildDateUTC>2025-11-09T21:27:05.6968153+10:00</d2p1:BuildDateUTC>
    <d2p1:CurrentTimeUTC>2025-11-09T21:27:05.6968153+10:00</d2p1:CurrentTimeUTC>
  </ServerInformation>
  <VersionInformation xmlns:d2p1="http://schemas.datacontract.org/2004/07/RimikAPI.Services.Metadata" />
  <Users xmlns:d2p1="http://schemas.datacontract.org/2004/07/RimikAPI.Models">
    <d2p1:APIStructs.User>
      <d2p1:AlertTimeframeEnd>PT0.1234567S</d2p1:AlertTimeframeEnd>
      <d2p1:AlertTimeframeStart>PT0.1234567S</d2p1:AlertTimeframeStart>
      <d2p1:ClientID>2</d2p1:ClientID>
      <d2p1:DateFormat>sample string 14</d2p1:DateFormat>
      <d2p1:DefaultDashboard>13</d2p1:DefaultDashboard>
      <d2p1:Email>sample string 6</d2p1:Email>
      <d2p1:EnableAlertTimeframe>true</d2p1:EnableAlertTimeframe>
      <d2p1:FamilyName>sample string 5</d2p1:FamilyName>
      <d2p1:GivenName>sample string 4</d2p1:GivenName>
      <d2p1:GraphTooltips>true</d2p1:GraphTooltips>
      <d2p1:ID>1</d2p1:ID>
      <d2p1:MobileNumber>sample string 8</d2p1:MobileNumber>
      <d2p1:TimeFormat>sample string 15</d2p1:TimeFormat>
      <d2p1:TimeZoneID>sample string 9</d2p1:TimeZoneID>
      <d2p1:UserName>sample string 3</d2p1:UserName>
      <d2p1:UserRole>Monitor</d2p1:UserRole>
      <d2p1:UserRoleDescription>sample string 7</d2p1:UserRoleDescription>
    </d2p1:APIStructs.User>
    <d2p1:APIStructs.User>
      <d2p1:AlertTimeframeEnd>PT0.1234567S</d2p1:AlertTimeframeEnd>
      <d2p1:AlertTimeframeStart>PT0.1234567S</d2p1:AlertTimeframeStart>
      <d2p1:ClientID>2</d2p1:ClientID>
      <d2p1:DateFormat>sample string 14</d2p1:DateFormat>
      <d2p1:DefaultDashboard>13</d2p1:DefaultDashboard>
      <d2p1:Email>sample string 6</d2p1:Email>
      <d2p1:EnableAlertTimeframe>true</d2p1:EnableAlertTimeframe>
      <d2p1:FamilyName>sample string 5</d2p1:FamilyName>
      <d2p1:GivenName>sample string 4</d2p1:GivenName>
      <d2p1:GraphTooltips>true</d2p1:GraphTooltips>
      <d2p1:ID>1</d2p1:ID>
      <d2p1:MobileNumber>sample string 8</d2p1:MobileNumber>
      <d2p1:TimeFormat>sample string 15</d2p1:TimeFormat>
      <d2p1:TimeZoneID>sample string 9</d2p1:TimeZoneID>
      <d2p1:UserName>sample string 3</d2p1:UserName>
      <d2p1:UserRole>Monitor</d2p1:UserRole>
      <d2p1:UserRoleDescription>sample string 7</d2p1:UserRoleDescription>
    </d2p1:APIStructs.User>
  </Users>
</GetUsersResponse>