POST
/api/mailing-lists/unsubscribePublicUnsubscribe from a mailing list
Records an unsubscribe for the address on the given mailing list; future sends to that list skip the address.
operationId
unsubscribeFromMailingListMailing ListsAuthentication & permissionsPublic
Anyone — no credentials required
- Accepted credentials
- None required
Request body
Required
application/json
LeaveMailingListRequestBody
| Property | Type | Description |
|---|---|---|
| email* | string (email) | Email address to unsubscribe. |
| mailing_list_id* | string (uuid) | ID of the mailing list to leave. |
JSONExample
"email""subscriber@example.com"
"mailing_list_id""b7d1f9c2-4a3e-4d24-9f6b-2f42f8f0a111"
Responses
application/json
SuccessMessageResponseSuccess envelope for operations with no response payload.
| Property | Type | Description |
|---|---|---|
| success* | true | |
| message* | string |
JSONExample
"success"true
"message""string"
Example request
bashcurl
curl -X POST 'https://mail.schemavaults.com/api/mailing-lists/unsubscribe' \
-H 'Content-Type: application/json' \
-d '{
"email": "subscriber@example.com",
"mailing_list_id": "b7d1f9c2-4a3e-4d24-9f6b-2f42f8f0a111"
}'