Add a number/numbers to a group (excluding 'merge' groups).
The following parameters should be used in a POST request:
The MSISDN (mobile number) you wish to add, if you want to add more then one use a comma delimited list.
The username of the source/master account, for authentication. Not required if you use HTTP Basic Authentication instead.
The password of the source/master account, for authentication. Not required if you use HTTP Basic Authentication instead.
The following parameters are DEPRECATED in favour of specifying the group ID/name in the URL. You should NOT use them in any new code, and should remove them from any existing code:
The unique ID of the group to add to.
OR you could previously use (now DEPRECATED):
The name of the group to add to.
Example successful response body XML:
A list of numbers that were successfully added to the group.
A list of numbers that were not added to the group because they were already present in a 'stop group'. A 'stop group' contains numbers that should not receive messages.
A list of numbers that were not added to the group because they were already present in the group.
The count of numbers in the added, stopped or duplicates list.
A mobile number that was added, stopped, or a duplicate. Note that this will always be in international format.
The group ID or name was not specified or was invalid.
A 404 status code is returned if the group specified does not exist.
Next: group PUT method
Home: All Documentation