PUT api/v2/admin/accounts/{id}

This method updates an existing account specified by the account Id in the URL. The system will check that the user has permission to update the account and that the account Id is valid. This method does not use all of the parameters of the Account model below. This method uses the following: Address, ContactNumber, Disclaimer, EmailAddress, FirstName, LanguageID, LastName, Logo, LogoName, Name, SMSPassword, SMSUsername, TimeZone, TwoFactorEnabled, Website

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The Id of the account to update its details.	globally unique identifier	Required

Body Parameters

Either xml or json request.

AccountV3

Name	Description	Type	Additional information
CountryCode	The dialing code of the country the account is registered in.	string	None.
NDD	The national dialing code of the country the account is registered in.	string	None.
IDD	The international dialing code used in the country the account it;s registered in.	string	None.
Timeout	The default timeout of the login in user.	integer	None.
Type	Gets the type of account which determines what the account can do to its subaccounts.	string	None.
ID	The unique identifier for the account.	globally unique identifier	None.
AccountID	The unique identifier for the parent account.	globally unique identifier	None.
Address	The address of the account.	string	None.
AnyTimeBalance	The anytime balance of the account.	decimal number	None.
ContactNumber	The contact number for the account.	string	Required Matching regular expression pattern: ^(?=.?\d.?\d.?\d.?\d.*?\d)([+]?)([\d\s-]{5,20})$
PhoneNumber	The contact number for the account.	string	Matching regular expression pattern: ^(?=.?\d.?\d.?\d.?\d.*?\d)([+]?)([\d\s-]{5,20})$
DateCreated	The date the account was created	date	None.
DateModified	The date the account was last modified	date	None.
Disclaimer	The text that is displayed at the bottom of the advanced messages.	string	None.
DisclaimerRemove	Determines if the disclaimer should be removed.	boolean	None.
EmailAddress	The main email address for the account.	string	Required Matching regular expression pattern: ^([0-9a-zA-Z]([-.\w'][0-9a-zA-Z])@([0-9a-zA-Z][-\w']*[0-9a-zA-Z]\.)+[a-zA-Z]{2,9})$
Enabled	Determines if the account is active or inactive.	boolean	None.
Defaultheader	The name of the default header	string	None.
LanguageID	The default language Id for the account.	globally unique identifier	None.
LanguageName	The name of the language	string	None.
Location	The country of the account.	string	None.
Logo	Base64 encoded string containing the logo that is displayed on advanced messages	string	None.
LogoRemoved	Determines if the logo should be removed.	boolean	None.
LogoName	The name of the logo file that is displayed on the web interface	string	None.
Name	The company name of the account.	string	None.
OffPeakBalance	The off peak balance of the account.	decimal number	None.
Preferences	Determines how the UI of SMS+ plus is displayed for this account. Provide a list of all preferences you wish to set on the account. Any preferences set previously will be overwritten with the preferences set on the request.	Collection of AccountPreferences	None.
SCIMEnabled	Determines if SCIM has been enabled on the account.	boolean	None.
SMSPassword	The password the account's 2sms account.	string	Required
SMSUsername	The username for the account's 2sms account.	string	Required
TimeZone	The default time zone for the account.	string	Required
TwoFactorEnabled	Determines if two factor authentication has been enabled on the account.	boolean	None.
URL	The Url for the account.	string	None.
Users	Displays all users that have access to this account along with their permissions.	Collection of AccountUserInfo	None.
Validated	Determines if the account has been validated.	boolean	None.
Website	The URL of the website for the account.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "UserPassword": "sample string 1",
  "CountryCode": "sample string 2",
  "NDD": "sample string 3",
  "IDD": "sample string 4",
  "Timeout": 5,
  "Type": "sample string 6",
  "ID": "9d0de4ff-373c-42b2-84dc-508d9be6c738",
  "AccountID": "e65db3e7-0157-47bd-ad4b-e6a543df8969",
  "Address": "sample string 8",
  "AnyTimeBalance": 1.1,
  "ContactNumber": "sample string 9",
  "PhoneNumber": "sample string 10",
  "DateCreated": "2024-12-22T19:00:30.9445288+00:00",
  "DateModified": "2024-12-22T19:00:30.9445288+00:00",
  "Disclaimer": "sample string 12",
  "EmailAddress": "sample string 14",
  "FirstName": "sample string 16",
  "Defaultheader": "sample string 17",
  "LanguageID": "d7f6dcc4-29a6-42e1-81fd-bf123715e396",
  "LanguageName": "sample string 19",
  "LastName": "sample string 20",
  "Location": "sample string 21",
  "Logo": "sample string 22",
  "LogoName": "sample string 24",
  "Name": "sample string 25",
  "OffPeakBalance": 1.1,
  "Preferences": [
    0,
    0
  ],
  "SCIMEnabled": true,
  "SMSPassword": "sample string 27",
  "SMSUsername": "sample string 28",
  "TimeZone": "sample string 29",
  "TwoFactorEnabled": true,
  "URL": "sample string 30",
  "Website": "sample string 32"
}

application/xml, text/xml

Sample:

<AccountV3 xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ID>9d0de4ff-373c-42b2-84dc-508d9be6c738</ID>
  <AccountID>e65db3e7-0157-47bd-ad4b-e6a543df8969</AccountID>
  <Address>sample string 8</Address>
  <AnyTimeBalance>1.1</AnyTimeBalance>
  <ContactNumber>sample string 9</ContactNumber>
  <PhoneNumber>sample string 10</PhoneNumber>
  <DateCreated>2024-12-22T19:00:30.9445288+00:00</DateCreated>
  <DateModified>2024-12-22T19:00:30.9445288+00:00</DateModified>
  <Disclaimer>sample string 12</Disclaimer>
  <DisclaimerRemove>true</DisclaimerRemove>
  <EmailAddress>sample string 14</EmailAddress>
  <Enabled>true</Enabled>
  <FirstName>sample string 16</FirstName>
  <Defaultheader>sample string 17</Defaultheader>
  <LanguageID>d7f6dcc4-29a6-42e1-81fd-bf123715e396</LanguageID>
  <LanguageName>sample string 19</LanguageName>
  <LastName>sample string 20</LastName>
  <Location>sample string 21</Location>
  <Logo>sample string 22</Logo>
  <LogoRemoved>true</LogoRemoved>
  <LogoName>sample string 24</LogoName>
  <Name>sample string 25</Name>
  <OffPeakBalance>1.1</OffPeakBalance>
  <Preferences>
    <AccountPreferences>ALL</AccountPreferences>
    <AccountPreferences>ALL</AccountPreferences>
  </Preferences>
  <SCIMEnabled>true</SCIMEnabled>
  <SMSPassword>sample string 27</SMSPassword>
  <SMSUsername>sample string 28</SMSUsername>
  <TimeZone>sample string 29</TimeZone>
  <TwoFactorEnabled>true</TwoFactorEnabled>
  <URL>sample string 30</URL>
  <Users>
    <AccountUserInfo>
      <UserID>75efad18-64fb-459b-af94-89357d11f969</UserID>
      <Name>sample string 2</Name>
      <PermissionLevel>STANDARD_USER</PermissionLevel>
    </AccountUserInfo>
    <AccountUserInfo>
      <UserID>75efad18-64fb-459b-af94-89357d11f969</UserID>
      <Name>sample string 2</Name>
      <PermissionLevel>STANDARD_USER</PermissionLevel>
    </AccountUserInfo>
  </Users>
  <Validated>true</Validated>
  <Website>sample string 32</Website>
  <CountryCode>sample string 2</CountryCode>
  <NDD>sample string 3</NDD>
  <IDD>sample string 4</IDD>
  <Timeout>5</Timeout>
  <Type>sample string 6</Type>
  <UserPassword>sample string 1</UserPassword>
</AccountV3>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Status message of the request

ResponseOfObject

Name	Description	Type	Additional information
Error		Error	None.
ResponseData		ResponseDataOfObject	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {}
  }
}

application/xml, text/xml

Sample:

<ResponseOfObject xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail />
  </ResponseData>
</ResponseOfObject>