Send Message to a group

In your account, there must be an existing group and numbers under that group to send any message to a group. API for sending a simple message to a group is in the following format:

curl -X POST \
'<BASE_URL>&method=groups&name=MyGroupName&sender=AAAAAA&message=sms+test'

An API for sending a customized message to a group is in the following format:

curl -X POST \
'<BASE_URL>&method=groups&name=MyGroupName&sender=AAAAAA&message=Dear {name}, Your email is {email}'

Here, {name} and {email} would be variable parameters and will be picked up from the existing group MYGROUP corresponding to each mobile number. Response formats would be same for simple message to a group or a customized one.

API Parameter Specifications

The API parameter specifications are described in the following sections.

Mandatory Parameters

The mandatory parameters in the HTTP API are tabulated below:

Optional Parameters

The Optional parameters in the HTTP API are tabulated below:

Example Responses

JSON

 {
    "status": "OK",
    "message": "Submitted successfully",
    "data": {
        "0": {
            "id": "4429996893:1",
            "customid": "",
            "customid1": "",
            "customid2": "",
            "mobile": "88xxxxxxxxx",
            "status": "AWAITED-DLR"
        },
        "1": {
            "id": "4429996893:2",
            "customid": "",
            "customid1": "",
            "customid2": "",
            "mobile": "97XXXXXXXX",
            "status": "AWAITED-DLR"
        },
        "group_id": 4429996893
    }
}

Error Response

{
    "status": "ERROR",
    "code": "A421",
    "message": "Group is empty/Invalid group"
}

Response Data

API Error Codes