Add contact

This method allows you to add some contacts to one of your list.

POST

/list

Body Parameters

value
required
The contact's number
listId
required
The list id
info1 Information 1
info2 Information 2
info3 Information 3
info4 Information 4

Examples


POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json

{
  "list": {
    "listId": "5a0331bffc5886074551ce97",
    "contacts": {
      "gsm": [
        {
          "value": "33612345678",
          "info1": "Hiroo",
          "info2": "Onoda"
        },
        {
          "value": "33612345677",
          "info1": "Grace",
          "info2": "Hopper"
        },
        {
          "value": "33612345676",
          "info1": "Hedy",
          "info2": "Lamarr",
          "info3": "Extase",
          "info4": "1933"
        }
      ]
    }
  }
}
          
        

POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<list>
  <listId>50433</listId>
  <contacts>
    <gsm info1="Hiroo" info2="Onoda">33612345678</gsm>
    <gsm info1="Grace" info2="Hopper">33612345677</gsm>
    <gsm info1="Hedy" info2="Lamarr" info3="Extase" info4="1933">33612345676</gsm>
  </contacts>
</list>
        
      

$response = \SMSFactor\ContactList::addContacts([
    'list' => [
      'list_id' => $list_id
      'contacts' => [
        'gsm' => [
          [
            'value' => '33612345678',
            'info1' => 'Hiroo',
            'info2' => 'Onoda'
          ],
          [
            'value' => '33612345677',
            'info1' => 'Grace',
            'info2' => 'Hopper'
          ],
          [
            'value' => '33612345676',
            'info1' => 'Hedy',
            'info2' => 'Lamarr',
            'info3' => 'Extase',
            'info4' => '1933'
          ]
        ]
      ]
    ]
]);
        
      

Result Format


{
  "status": 1,
  "message": "OK",
  "contacts": 3,
  "invalid": 0,
  "duplicates": 0,
  "id": "50433"
}
          
        

<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <status>1</status>
  <message>OK</message>
  <contacts>3</contacts>
  <invalid>0</invalid>
  <duplicates>0</duplicates>
  <id>50433</id>
</response>