Turn product email categories and account reminders on or off, and give or withdraw marketing consent.
PUT/v1/me/email-preferencesTry it
Session token
Changes your marketing consent, your email categories, or both. Only what you send changes; categories you leave out keep their current value.
Note
Requires a session JWT — a dashboard session or an stx login token. API keys are rejected with 401. Any plan.
Request Body
Send categories, marketing, or both. Any other key is a 400 validation_error.
NameDescription
categories:objectbody
Any of product_tips, account_nudges, reports, news and account, each true (get it) or false (don't) — see Get Email Preferences for what each one is. account (account reminders) works whatever your marketing consent is.
marketing:booleanbody
true records an explicit opt-in (granted), false withdraws consent (denied), wherever you are.
Turning anything back on — marketing: true or any category true — also lifts an earlier unsubscribe from all. It doesn't lift a block caused by your address bouncing or a spam report.