Contacts

Create contact

Changed on Nov 3, 2026

Requires authentication — see Authentication.

Creates a contact within a list. Returns the id used as subscriberId by all contact endpoints for that list.

post/v3/lists/{listId}/subscribers

Request

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

Path parameters

listIdinteger required

Provide the unique ID of the list

Request body

string required

Response

Accepted the request to create the contact

Example response

{
  "meta": {
    "timestamp": 1597166699457,
    "transactionId": "70169d77-c165-4795-9932-35b8a3af96fb",
    "explain": "a descriptive text"
  },
  "data": {
    "data": {
      "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"
    }
  }
}

Changes

Nov 3, 202647d573a56b26 Revision changes
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  api tag Contacts added
- info
  api tag Subscribers removed
- info
  added the non-success response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status

Operation history