MEmessangi
Contacts

Create multiple contacts

Changed on

Requires authentication — see Authentication.

Adds multiple contacts via JSON body or from a CSV file to a certain list previously created. You need to provide the unique identifier (listId) of the list you want to add the multiple contacts.

This endpoint is used in the List Management guide.

post/v3/lists/{listId}/subscribers/bulk

Request

  • Base URL
    https://elastic.messangi.me/qarth
  • URL
    https://elastic.messangi.me/qarth/v3/lists/{listId}/subscribers/bulk
  • Auth
    HTTP bearer

Path parameters

listIdinteger required

Provide the unique ID of the list

Request body

string required

Response

Accepted the request to create multiple contacts

Example response

{
  "meta": {
    "timestamp": 1597166699457,
    "transactionId": "70169d77-c165-4795-9932-35b8a3af96fb",
    "explain": "a descriptive text"
  },
  "data": {
    "subscriberUpdated": 5,
    "subscriberAdded": 10,
    "subscribersError": [
      {
        "address": "12345",
        "member since": "2020-10-05T13:09:10.233573Z",
        "last updated": "2020-10-05T13:09:10.233573Z",
        "mobile": "unknown.5f7b1af6535f6b5151040776",
        "id": "5f7b1af6535f6b5151040776",
        "email": "The Tester"
      },
      {
        "address": "6789",
        "member since": "2020-10-05T13:09:10.233573Z",
        "last updated": "2020-10-05T13:09:10.233573Z",
        "mobile": "unknown.5f7b1af6535f6b5151040885",
        "id": "5f7b1af6535f6b5151040885",
        "email": "The Other Tester"
      }
    ]
  }
}

Changes

  • 47d573a56b26Revision changes
    • info

      api tag Contacts added

    • info

      api tag Subscribers removed

    • info

      added the non-success response with the status