MepMail Docs
API referenceEndpointsContactsIdPreferences link

Mint a preference-center link for a contact

POST
/contacts/{id}/preferences-link

MepMail extension. Returns the contact's hosted preferences URL, the same page the unsubscribe links in their emails open, so a product settings screen can deep-link into it. The page lists the team's public topics and carries the global unsubscribe. The link is a signed, contact-scoped capability with no expiry: anyone holding it can change that contact's preferences, so hand it only to the contact.

AuthorizationBearer <token>

An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/contacts/string/preferences-link"
{  "object": "preferences_link",  "contact": "ae2014de-c168-4c61-8267-70d2662a1ce1",  "url": "https://example.com/link"}