mndrAPI Docs
Contacts

Subscriptions

Update email and WhatsApp subscription status.

PATCH /api/v1/contacts/:id/subscriptions

Update a contact's email and/or WhatsApp subscription status. At least one field is required.

Parameters

ParameterTypeDescription
emailSubscriptionStatus"subscribed" | "unsubscribed"Email subscription status
whatsappSubscriptionStatus"subscribed" | "unsubscribed"WhatsApp subscription status

Example

Unsubscribe from email
curl -X PATCH /api/v1/contacts/uuid-here/subscriptions \
  -H "x-api-key: mndr_..." \
  -H "Content-Type: application/json" \
  -d '{ "emailSubscriptionStatus": "unsubscribed" }'
Response (200)
{
  "contact": {
    "id": "uuid",
    "emailSubscriptionStatus": "unsubscribed",
    "whatsappSubscriptionStatus": "subscribed",
    ...
  }
}

On this page