mndrAPI Docs
Contacts

Update Contact

Update an existing contact by ID.

PUT /api/v1/contacts/:id

Update a contact by ID. Only provided fields are changed — omitted fields keep their current values.

Parameters

All fields are optional:

ParameterTypeDescription
emailstringEmail address
phonestring | nullPhone number (set to null to clear)
firstNamestring | nullFirst name
lastNamestring | nullLast name
tagsstring[]Replaces existing tags
customFieldsobjectReplaces existing custom fields
emailSubscriptionStatus"subscribed" | "unsubscribed"Email subscription status
whatsappSubscriptionStatus"subscribed" | "unsubscribed"WhatsApp subscription status

Example

Request
curl -X PUT /api/v1/contacts/uuid-here \
  -H "x-api-key: mndr_..." \
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "Janet",
  "tags": ["vip"]
}'
Response (200)
{
  "contact": {
    "id": "uuid",
    "email": "jane@example.com",
    "firstName": "Janet",
    "tags": ["vip"],
    ...
  }
}

On this page