Add Contacts to a Group using JSON/XML Data

First, you need to create a group in your account only then you can add multiple contacts to an existing valid group. APIs for adding contacts to a group using JSON/XML data have been specified below:

curl -X POST \
'<BASE_URL>&api_key=xxxxxxxxxxxxxxxx&method=groups.json&name=MyNum&action=add&json=%7B%22sms%22%3A%20%5B%7B%20%22to%22%3A%20%229xxxxxxxx......%7D%5D%20%7D'

curl -X POST \
'<BASE_URL>&api_key=xxxxxxxxxxxxxxxx&method=groups.xml&name=MyNum&action=add&xml=%7B%22sms%22%3A%20%5B%7B%20%22to%22%3A%20%229xxxxxxxx......%7D%5D%20%7D'

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:

Note: If you want to use 'Delete' functionality for deleting any contact, then simply use 'delete' value within 'action' parameter.

JSON/XML Tags

Sample JSON Data

  {
    "contacts": 
    [{ 
        "number": "9xxxxxxxx", 
        "fullname": "xyz", 
        "email": "xyz@email.com"  
      }, 
      {
        "number":"91xxxxxxxx",   
        "fullname":"xyz1",
        "email":"xyz1@email.com"  
      }] 
  }

Sample XML Data

<?xml version="1.0" encoding="UTF-8"?>
<xmlapi>
  <contacts>
    <contact>
      <number>95xxxxxxxx</number>
      <fullname>xyz</fullname>
      <email>x@email.com</email>
    </contact>

    <contact>
      <number>99xxxxxxxx</number>
      <fullname>xyz1</fullname>
      <email>y@email.com</email>
    </contact>
  </contacts>
</xmlapi>

Example Responses

JSON

{
    "status": "OK",
    "code": 200,
    "message": "Number updated Successfully"
}

Error Response:

 {
      "status": "ERROR",
      "code": "A424",
      "message": "Group Name does not exist!"
}

API Error Codes

Response Data