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

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

Request Body

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

Schema

{
  "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

{
  "api_key": "{{api_key}}",
  "contacts": [
    {
      "contactListId": "113056",
      "numbers": [
        "91913632xxxx",
        "91888877xxxx"
      ],
      "tagAdd": [
        274,
        275
      ]
    }
  ]
}

Example Success Response (200)

{
  "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.