https://business.me-mate.net/api/betav3/tagmanage/tag/addTagToContacts | Messenger Mate

Purpose

Add one or more tags to one or more contacts (phone numbers) within a specific contact list. The API queues a background job to apply the requested tags.

Endpoint

POST https://business.me-mate.net/api/betav3/tagmanage/tag/addTagToContacts

Auth / Variables

This endpoint uses an API key passed in the request body.

{{api_key}} (string): Your API key.

Headers

Header	Value	Notes
`X-Requested-With`	`XMLHttpRequest`	Required by the backend for this endpoint.

Request Body

Content-Type: application/json (raw JSON body)

Schema

1 {
2   "api_key": "string",
3   "contacts": [
4     {
5       "contactListId": "string",
6       "numbers": ["string"],
7       "tagAdd": [0]
8     }
9   ]
10 }

Field notes

api_key (string, required): Use {{api_key}}.
contacts (array, required): List of contact-tag operations.
- contactListId (string, required): Target contact list ID.
- numbers (string[], required): One or more phone numbers to tag.
- tagAdd (number[], required): One or more tag IDs to add.

Example

1 {
2   "api_key": "{{api_key}}",
3   "contacts": [
4     {
5       "contactListId": "113056",
6       "numbers": [
7         "91913632xxxx",
8         "91888877xxxx"
9       ],
10       "tagAdd": [
11         274,
12         275
13       ]
14     }
15   ]
16 }

Example Success Response (200)

1 {
2   "status": true,
3   "msg": "Tag add jobs queued",
4   "queued_jobs": 1,
5   "skipped_items": 0
6 }

Notes

A successful response indicates the tagging job(s) were queued; the tag application may complete asynchronously.

## Purpose Add one or more tags to one or more contacts (phone numbers) within a specific contact list. The API queues a background job to apply the requested tags. ## Endpoint `POST https://business.me-mate.net/api/betav3/tagmanage/tag/addTagToContacts` ## Auth / Variables This endpoint uses an API key passed in the request body. - `{{api_key}}` (string): Your API key. ## Headers | Header | Value | Notes | | --- | --- | --- | | `X-Requested-With` | `XMLHttpRequest` | Required by the backend for this endpoint. | ## Request Body **Content-Type:** `application/json` (raw JSON body) ### Schema ``` json { "api_key": "string", "contacts": [ { "contactListId": "string", "numbers": ["string"], "tagAdd": [0] } ] } ``` ### Field notes - `api_key` _(string, required)_: Use `{{api_key}}`. - `contacts` _(array, required)_: List of contact-tag operations. - `contactListId` _(string, required)_: Target contact list ID. - `numbers` _(string\[\], required)_: One or more phone numbers to tag. - `tagAdd` _(number\[\], required)_: One or more tag IDs to add. ### Example ``` json { "api_key": "{{api_key}}", "contacts": [ { "contactListId": "113056", "numbers": [ "91913632xxxx", "91888877xxxx" ], "tagAdd": [ 274, 275 ] } ] } ``` ## Example Success Response (200) ``` json { "status": true, "msg": "Tag add jobs queued", "queued_jobs": 1, "skipped_items": 0 } ``` ## Notes - A successful response indicates the tagging job(s) were queued; the tag application may complete asynchronously.

Request

This endpoint expects an object.

api_keystringRequired

contactslist of objectsRequired

Response

msgstring

statusboolean

queued_jobsinteger

skipped_itemsinteger