https://business.me-mate.net/partners/broadcast/uploadMultiContact | Messenger Mate

curl -X POST https://business.me-mate.net/partners/broadcast/uploadMultiContact \
     -H "X-Requested-With: XMLHttpRequest" \
     -H "Content-Type: application/json" \
     -d "{
    \"contacts\": [
        {
            \"contactListId\": \"112998\", // contact list id
            \"numbers\": [
                {
                    \"number\": \"7974758xxxx\", // contact number
                    \"name\": \"Aman WABA Number\" // contact name
                },
                {
                    \"number\": \"7974758xxxx\",
                    \"name\": \"Support Team sd\" // on duplicate new contact will create
                }
            ]
        },
        {
            \"contactListId\": \"112998\",
            \"numbers\": [
                {
                    \"number\": \"889977xxxx\",
                    \"name\": \"Sales Department\"
                },
                {
                    \"number\": \"998877xxxx\",
                    \"name\": \"Marketing Team\"
                }
            ]
        }
    ]
}"

{
  "msg": "Contacts processed!",
  "added": [
    {
      "tag": "112998",
      "name": "Sales Department",
      "number": "8899776655",
      "unsubscribed": 0
    },
    {
      "tag": "112998",
      "name": "Marketing Team",
      "number": "9988776655",
      "unsubscribed": 0
    }
  ],
  "failed": [
    {
      "key": "value"
    }
  ],
  "status": true,
  "summary": {
    "added": 2,
    "failed": 0,
    "updated": 1,
    "requested": 3,
    "plan_remaining_before": 99940,
    "ignored_due_to_plan_limit": 0
  },
  "updated": [
    {
      "tag": "112998",
      "number": "79747583534",
      "message": "Contact existed, name updated",
      "new_name": "Aman WABA Number",
      "old_name": "aman waba number"
    }
  ],
  "ignored_due_to_plan_limit": [
    {
      "key": "value"
    }
  ]
}

Purpose

Uploads multiple contacts into one or more contact lists in a single request. This endpoint processes each contact number entry and either adds a new contact or updates the existing contact’s name if the number already exists in the specified list.

Endpoint: POST https://business.me-mate.net/partners/broadcast/uploadMultiContact

Authentication

This endpoint requires an authentication token.

Use the existing global variable:

1 Authorization: Bearer {{auth token}}

If your API uses a different auth scheme, keep using {{auth token}} in the appropriate header/value format required by your backend.

Required Headers

1 X-Requested-With: XMLHttpRequest
2 Content-Type: application/json
3 Authorization: Bearer {{auth token}}

Request Body Schema (JSON)

The body is a JSON object with the following structure:

contacts (array, required): List of contact batches to upload.
- Each item in contacts:
  - contactListId (string, required): Target contact list ID.
  - numbers (array, required): List of contacts (numbers) to add/update.
    - Each item in numbers:
      - number (string, required): Contact phone number.
      - name (string, required): Contact name.

Behavior for duplicates

If the same number already exists in the given contactListId, the system updates the contact name and returns an entry under updated.
If it does not exist, it is created and returned under added.

Example Request Payload

1 {
2     "contacts": [
3         {
4             "contactListId": "112998", 
5             "numbers": [
6                 {
7                     "number": "79747583534", 
8                     "name": "Aman WABA Number" 
9                 },
10                 {
11                     "number": "79747583534",
12                     "name": "Support Team sd" 
13                 }
14             ]
15         },
16         {
17             "contactListId": "112998",
18             "numbers": [
19                 {
20                     "number": "8899776655",
21                     "name": "Sales Department"
22                 },
23                 {
24                     "number": "9988776655",
25                     "name": "Marketing Team"
26                 }
27             ]
28         }
29     ]
30 }

Example Success Response (200)

1 {
2   "status": true,
3   "msg": "Contacts processed!",
4   "summary": {
5     "requested": 3,
6     "added": 2,
7     "updated": 1,
8     "failed": 0,
9     "ignored_due_to_plan_limit": 0,
10     "plan_remaining_before": 99940
11   },
12   "added": [
13     {
14       "tag": "112998",
15       "number": "8899776655",
16       "name": "Sales Department",
17       "unsubscribed": 0
18     },
19     {
20       "tag": "112998",
21       "number": "9988776655",
22       "name": "Marketing Team",
23       "unsubscribed": 0
24     }
25   ],
26   "updated": [
27     {
28       "tag": "112998",
29       "number": "79747583534",
30       "old_name": "aman waba number",
31       "new_name": "Aman WABA Number",
32       "message": "Contact existed, name updated"
33     }
34   ],
35   "failed": [],
36   "ignored_due_to_plan_limit": []
37 }

Notes on `summary`

requested: Total unique contact numbers requested for processing (as counted by the backend).
added: Count of contacts created.
updated: Count of existing contacts whose name was updated.
failed: Count of contacts that failed to process.
ignored_due_to_plan_limit: Count ignored due to plan limits.
plan_remaining_before: Remaining plan quota before this operation ran.

### Purpose Uploads multiple contacts into one or more contact lists in a single request. This endpoint processes each contact number entry and either **adds a new contact** or **updates the existing contact’s name** if the number already exists in the specified list. **Endpoint**: `POST https://business.me-mate.net/partners/broadcast/uploadMultiContact` --- ### Authentication This endpoint requires an authentication token. Use the existing global variable: ``` http Authorization: Bearer {{auth token}} ``` > If your API uses a different auth scheme, keep using `{{auth token}}` in the appropriate header/value format required by your backend. --- ### Required Headers ``` http X-Requested-With: XMLHttpRequest Content-Type: application/json Authorization: Bearer {{auth token}} ``` --- ### Request Body Schema (JSON) The body is a JSON object with the following structure: - `contacts` _(array, required)_: List of contact batches to upload. - Each item in `contacts`: - `contactListId` _(string, required)_: Target contact list ID. - `numbers` _(array, required)_: List of contacts (numbers) to add/update. - Each item in `numbers`: - `number` _(string, required)_: Contact phone number. - `name` _(string, required)_: Contact name. **Behavior for duplicates** - If the same `number` already exists in the given `contactListId`, the system **updates the contact name** and returns an entry under `updated`. - If it does not exist, it is created and returned under `added`. --- ### Example Request Payload ``` json { "contacts": [ { "contactListId": "112998", "numbers": [ { "number": "79747583534", "name": "Aman WABA Number" }, { "number": "79747583534", "name": "Support Team sd" } ] }, { "contactListId": "112998", "numbers": [ { "number": "8899776655", "name": "Sales Department" }, { "number": "9988776655", "name": "Marketing Team" } ] } ] } ``` --- ### Example Success Response (200) ``` json { "status": true, "msg": "Contacts processed!", "summary": { "requested": 3, "added": 2, "updated": 1, "failed": 0, "ignored_due_to_plan_limit": 0, "plan_remaining_before": 99940 }, "added": [ { "tag": "112998", "number": "8899776655", "name": "Sales Department", "unsubscribed": 0 }, { "tag": "112998", "number": "9988776655", "name": "Marketing Team", "unsubscribed": 0 } ], "updated": [ { "tag": "112998", "number": "79747583534", "old_name": "aman waba number", "new_name": "Aman WABA Number", "message": "Contact existed, name updated" } ], "failed": [], "ignored_due_to_plan_limit": [] } ``` --- ### Notes on `summary` - `requested`: Total unique contact numbers requested for processing (as counted by the backend). - `added`: Count of contacts created. - `updated`: Count of existing contacts whose name was updated. - `failed`: Count of contacts that failed to process. - `ignored_due_to_plan_limit`: Count ignored due to plan limits. - `plan_remaining_before`: Remaining plan quota before this operation ran.

Request

This endpoint expects a string.

Response

msgstring

addedlist of objects

failedlist of any

statusboolean

summaryobject

updatedlist of objects

ignored_due_to_plan_limitlist of any

{
    "contacts": [
        {
            "contactListId": "112998", 
            "numbers": [
                {
                    "number": "79747583534", 
                    "name": "Aman WABA Number" 
                },
                {
                    "number": "79747583534",
                    "name": "Support Team sd" 
                }
            ]
        },
        {
            "contactListId": "112998",
            "numbers": [
                {
                    "number": "8899776655",
                    "name": "Sales Department"
                },
                {
                    "number": "9988776655",
                    "name": "Marketing Team"
                }
            ]
        }
    ]
}

{
  "status": true,
  "msg": "Contacts processed!",
  "summary": {
    "requested": 3,
    "added": 2,
    "updated": 1,
    "failed": 0,
    "ignored_due_to_plan_limit": 0,
    "plan_remaining_before": 99940
  },
  "added": [
    {
      "tag": "112998",
      "number": "8899776655",
      "name": "Sales Department",
      "unsubscribed": 0
    },
    {
      "tag": "112998",
      "number": "9988776655",
      "name": "Marketing Team",
      "unsubscribed": 0
    }
  ],
  "updated": [
    {
      "tag": "112998",
      "number": "79747583534",
      "old_name": "aman waba number",
      "new_name": "Aman WABA Number",
      "message": "Contact existed, name updated"
    }
  ],
  "failed": [],
  "ignored_due_to_plan_limit": []
}

1	X-Requested-With: XMLHttpRequest
2	Content-Type: application/json
3	Authorization: Bearer {{auth token}}

1	{
2	"contacts": [
3	{
4	"contactListId": "112998",
5	"numbers": [
6	{
7	"number": "79747583534",
8	"name": "Aman WABA Number"
9	},
10	{
11	"number": "79747583534",
12	"name": "Support Team sd"
13	}
14	]
15	},
16	{
17	"contactListId": "112998",
18	"numbers": [
19	{
20	"number": "8899776655",
21	"name": "Sales Department"
22	},
23	{
24	"number": "9988776655",
25	"name": "Marketing Team"
26	}
27	]
28	}
29	]
30	}

1	{
2	"status": true,
3	"msg": "Contacts processed!",
4	"summary": {
5	"requested": 3,
6	"added": 2,
7	"updated": 1,
8	"failed": 0,
9	"ignored_due_to_plan_limit": 0,
10	"plan_remaining_before": 99940
11	},
12	"added": [
13	{
14	"tag": "112998",
15	"number": "8899776655",
16	"name": "Sales Department",
17	"unsubscribed": 0
18	},
19	{
20	"tag": "112998",
21	"number": "9988776655",
22	"name": "Marketing Team",
23	"unsubscribed": 0
24	}
25	],
26	"updated": [
27	{
28	"tag": "112998",
29	"number": "79747583534",
30	"old_name": "aman waba number",
31	"new_name": "Aman WABA Number",
32	"message": "Contact existed, name updated"
33	}
34	],
35	"failed": [],
36	"ignored_due_to_plan_limit": []
37	}

Purpose

Authentication

Required Headers

Request Body Schema (JSON)

Example Request Payload

Example Success Response (200)

Notes on summary

Headers

Request

Response

Purpose

Authentication

Required Headers

Request Body Schema (JSON)

Example Request Payload

Example Success Response (200)

Notes on summary

Notes on `summary`

Notes on `summary`