Skip to navigation
View as Markdown

Updates an existing tag (name, access scope, and optional description) in the MessengerMate Tag Management API.

Method & URL
POST https://business.me-mate.net/api/betav3/tagmanage/tag/update

Authentication

This endpoint expects an API key sent in the request body.

  • api_key (string, required) — Use the Postman variable {{api_key}}.

If the API key is missing/invalid, the API will likely return 401 Unauthorized or 403 Forbidden.

Required headers

  • X-Requested-With: XMLHttpRequest

Request body (JSON)

Send a JSON object with the following fields:

FieldTypeRequiredDescriptionAllowed / Validation
api_keystringYesAPI key used to authorize the request.Must be valid.
tag_idintegerYesThe ID of the tag to update.Must refer to an existing tag.
tag_namestringNoUpdated tag name.If provided, should be a non-empty string.
access_typestringNoVisibility/scope of the tag.Enum: private
TagDescriptionstringNoShort description for the tag.Max length 255 characters

Notes / validation rules

  • TagDescription must be ≤ 255 characters.

  • access_type must be one of: private, public, admin.

  • If validation fails, the API will likely return 422 Unprocessable Entity.

Example request

{
"api_key": "{{api_key}}",
"tag_id": 275,
"tag_name": "New Customer changed",
"access_type": "private",
"TagDescription": "Short description about the tag"
}

Example success response (200)

{
"message": "Tag updated successfully",
"data": {
"tag_name": "New Customer changed",
"tag_id": 275
}
}

Likely error responses

  • 401 Unauthorized — Missing/invalid api_key.

  • 403 Forbidden — API key does not have permission to update tags.

  • 422 Unprocessable Entity — Validation errors (e.g., invalid access_type, TagDescription > 255, missing required fields).

Headers

X-Requested-WithstringOptional

Request

This endpoint expects a string.

Response

OK
dataobject
messagestring