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

NameDescriptionTypeAdditional information
id

The Id of the account to update its details.

globally unique identifier

Required

Body Parameters

Either xml or json request.

AccountV3
NameDescriptionTypeAdditional 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

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": "654126f7-a940-4215-815e-4a3dda7d5f31",
  "AccountID": "08f91e59-f833-4382-9231-373de7356aaf",
  "Address": "sample string 8",
  "AnyTimeBalance": 1.1,
  "ContactNumber": "sample string 9",
  "PhoneNumber": "sample string 10",
  "DateCreated": "2022-01-27T11:56:01.0267565+00:00",
  "DateModified": "2022-01-27T11:56:01.0267565+00:00",
  "Disclaimer": "sample string 12",
  "EmailAddress": "sample string 14",
  "FirstName": "sample string 16",
  "Defaultheader": "sample string 17",
  "LanguageID": "454c0fec-8a48-4a11-b36d-531b04678c3d",
  "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>654126f7-a940-4215-815e-4a3dda7d5f31</ID>
  <AccountID>08f91e59-f833-4382-9231-373de7356aaf</AccountID>
  <Address>sample string 8</Address>
  <AnyTimeBalance>1.1</AnyTimeBalance>
  <ContactNumber>sample string 9</ContactNumber>
  <PhoneNumber>sample string 10</PhoneNumber>
  <DateCreated>2022-01-27T11:56:01.0267565+00:00</DateCreated>
  <DateModified>2022-01-27T11:56:01.0267565+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>454c0fec-8a48-4a11-b36d-531b04678c3d</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>f410c7e1-43d4-4ef0-96b2-0c1edf3e7fc6</UserID>
      <Name>sample string 2</Name>
      <PermissionLevel>STANDARD_USER</PermissionLevel>
    </AccountUserInfo>
    <AccountUserInfo>
      <UserID>f410c7e1-43d4-4ef0-96b2-0c1edf3e7fc6</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
NameDescriptionTypeAdditional 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>