Save preferences from a signed email link
The signed token scopes the email address and organization. With only token, a category link opts out of its source category; a legacy link stops all email. Explicit changes apply only the named categories. Individual account_security changes are forbidden, and category links cannot disable all email. restore_all_email is exclusive of individual changes/disable_all_email; disable_all_email cannot be combined with enabling categories. SMS/postal changes are rejected. Restore clears stored opt-outs while donor/form suppression remains.
Body
Validated request fields for this operation.
Token. Validation: required, string, max:4096.
4096"signed-link-token"
Disable email categories. Validation: sometimes, array.
Disable email categories item. Validation: string, max:100.
marketing, receipts_tax, payment_issues, sponsorship_updates, events_fundraising, messages, files_photos, other_updates 100Enable email categories. Validation: sometimes, array.
Enable email categories item. Validation: string, max:100.
marketing, receipts_tax, payment_issues, sponsorship_updates, events_fundraising, messages, files_photos, other_updates 100Accepted only as false; true is rejected because this signed link controls email only.
true
Accepted only as false; true is rejected because this signed link controls email only.
true
Disable all email. Validation: sometimes, boolean.
true
Restore all email. Validation: sometimes, boolean.
true
Response
Operation result.
"Email preferences saved."
marketing, account_security, receipts_tax, payment_issues, sponsorship_updates, events_fundraising, messages, files_photos, other_updates, null "marketing"
True for a whole-email legacy signed link.
true