Adding Contact Groups
Description
When adding a new Contact Group, calls to the API must be made via URL:
http://www.webtext.com/api/add_contact_group.html
https://www.webtext.com/api/add_contact_group.html
Mandatory Parameters when adding a contact group.
|
api_id |
This is your WebTEXT API id, unique to your WebTEXT account. Issued on request by WebTEXT (support@webtext.com). Note that this is NOT your WebTEXT user name. |
|
api_pwd |
API password, as issued to you by WebTEXT. |
|
group_name |
The name you wish to assign to the new group. |
Usage Example
This is a sample GET request, adding a new group, called 'My Group' to my list of Contact Groups.
http://www.webtext.com/api/add_contact_group.html?api_id=myid&api_pwd=mypwd&group_name=My%20Group
A successful call to the API, to add a Contact Group, will return the string: “000 alias:xxxxxxxxx”, where xxxxxxxxx is the group alias assigned by the server.
An unsuccessful call will return a 3-digit error code, which can be found in the table 'RETURN CODES', at the end of this document. For example, attempting to add a group which already exists within your account, will return the error code 407