mndrAPI Docs
Contacts

Manage Tags

Add or remove tags from a contact.

Add Tags

POST /api/v1/contacts/:id/tags

Add tags to a contact. Duplicates are automatically ignored.

ParameterTypeRequiredDescription
tagsstring[]YesTags to add
Request
curl -X POST /api/v1/contacts/uuid-here/tags \
  -H "x-api-key: mndr_..." \
  -H "Content-Type: application/json" \
  -d '{ "tags": ["vip", "early-adopter"] }'
Response (200)
{
  "contact": {
    "id": "uuid",
    "tags": ["customer", "vip", "early-adopter"],
    ...
  }
}

Remove Tags

DELETE /api/v1/contacts/:id/tags

Remove specific tags from a contact. Tags not present on the contact are ignored.

ParameterTypeRequiredDescription
tagsstring[]YesTags to remove
Request
curl -X DELETE /api/v1/contacts/uuid-here/tags \
  -H "x-api-key: mndr_..." \
  -H "Content-Type: application/json" \
  -d '{ "tags": ["churned"] }'

Delete Contact

Delete a contact by ID.

Subscriptions

Update email and WhatsApp subscription status.

On this page

Add TagsPOST /api/v1/contacts/:id/tagsRemove TagsDELETE /api/v1/contacts/:id/tags