Create a new account, linked to your main account (requires additional p= ermissions on your account, please contact Text Marketer to apply).
Hashtable<String, String> account;
account =3D tmClient.createSubAccount("My Client", "44700000=
0000",=20
"notifications@myclient.com", "newusername", "newp=
assword", "PROMOCODE", true);
System.out.println("Account ID: " + account.get("account_id&=
quot;));
=20
Arguments:
String companyName:
the company name for the new account. Between 3 and 40 characters, inclu= sive. No special restrictions.
String notificationMobile:
(optional*) a mobile number to which notifications and alerts are sent. = Must be a valid UK mobile number. *Required if notificationEmail is not set.
String notificationEmail:
(optional*) an email address to which notifications and alerts are sent.= *Required if notificationMobile is not set.
String username:
(optional) the username you wish to set on the new account - the API use= rname will be the same. Between 5 and 20 characters, inclusive. Alpha-numer= ic (no accented letters), '-' and '_' characters allowed. If this is not se= t, one will be set for you.
String password:
(optional) the password you wish to set on the new account - the API pas= sword will be the same. Between 5 and 20 characters, inclusive. Alpha-numer= ic (no accented letters), '-' and '_' characters allowed. If this is not se= t, one will be set for you.
String promoCode:
(optional) a promotional code entitling the new account to extra credits= .
boolean overrideRates:
if set to true, use the credits rates set on your main account (the acco= unt used to access the API), rather than the Text Marketer defaults.
Returns:
an Hashtable<String, String> with 10 keys: 'api_password', 'api_us= ername', 'company_name', 'create_date', 'credits', 'password' and 'username= ', 'notification_email', 'notification_mobile', 'account_id'
| Hashtable key | Value |
|---|---|
| api_password | String. The new account API password |
| api_username | String. The new account API username |
| company_name | String. The new account company name |
| create_date | String. The creation date of the account in I= SO 8601 format |
| credit | Integer. The number of credits on the new acc= count. |
| password | String. The new account web interface passwor= d. |
| username | String. The new account web interface username.<= /td> |
| notification_email | String. The new account email address used fo= r notifications. |
| notification_mobile | String. The new account UK mobile number used= for notifications. |
| account_id | String. The ID of the account used for identi= fication in other functions. |
Specific error codes:
| Code | Meaning |
|---|---|
| 0 | Either the email address or mobile number must b= e supplied. |
| 1 | The company name must be supplied. |
| 2 | The email address you specified is invalid. |
| 3 | The mobile number you specified is not a vali= d UK mobile number. |
| 4 | A value you tried to set is either too long o= r too short. See specific error text. |
| 5 | A value you tried to set does not match the requ= ired pattern. See specific error text. |
| 6 | A parameter was missing (see specific error text= ). |
| 7 | The username you specified is already in use. Pl= ease choose another. |
| 8 | You have reached your limit for= the number of accounts you can create. Please contact Text Marketer to inc= rease this. |