Batch Add Contacts

1.   / 
2. API   / 
3. Address Book   / 
4. Batch Add

---

Description

wss contacts

All the same as in contact_add but focused on sending several contacts at once.

Address Book / Add

Example

Request

{
  "request": {
    "contacts": [
      {
        "first_name": "Name",
        "last_name": "Surname",
        "company": "UserCompany",
        "email": [ { "type": "work", "value": "..." } ],
        "phone": [ { "type": "home", "value": "..." } ]
      },
      {
        "first_name": "Name2",
        "last_name": "Surname2",
        "company": "UserCompany2",
        "email": [ { "type": "work", "value": "..." } ],
        "phone": [ { "type": "home", "value": "..." } ]
      },
      ...
    ]
    "id": "RequestId"
   }
}

Response

{
  "response": {
    "id": "RequestId",
    "contacts": [
      {
        "_id": "63480e68f4794709f802a2fa",
        "first_name": "Name",
        "last_name": "Surname",
        "company": "UserCompany",
        "email": [{ "type": "home", "value": "..." }],
        "phone": [
          { "type": "home", "value": "...", "matched_user_id": "UID7" }
        ],
        "updated_at": "2025-08-13T05:51:44.733Z",
        "created_at": "2025-08-13T05:51:44.733Z"
      },
      {
        "_id": "63480e68f4794709f802a2fy",
        "first_name": "Name2",
        "last_name": "Surname2",
        "company": "UserCompany2",
        "email": [{ "type": "home", "value": "..." }],
        "phone": [
          { "type": "home", "value": "...", "matched_user_id": "UID6" }
        ],
        "updated_at": "2025-08-13T05:51:44.733Z",
        "created_at": "2025-08-13T05:51:44.733Z"
      }
    ]
  }
}

See Also

SAMA chat server API: Address book Each of us has at least once faced a situation where we wanted to write to an friend from our contact list, but couldn’t find them on the platform. That is why...