Update email preferences
POST /v1/account/email-preferencesFreeWrites
Turns automated emails on or off: `subscribed: false` stops all of them (the same as the unsubscribe link), `subscribed: true` resubscribes, and `kinds` switches individual kinds. Kinds not named keep their setting. Free. Returns the preferences after the change.
MCP tool update_email_preferences · CLI geocode update-email-preferences · RPC POST /v1/ops/update_email_preferences
Input
| Field | Type | Description |
|---|---|---|
subscribedbody | boolean | false = unsubscribe from every automated email; true = resubscribe. |
kindsbody | object | Per-kind switches, e.g. {"digest": false}. |
Example request
curl -X POST "https://geo-coder-service.vercel.app/v1/account/email-preferences" \ -H "Authorization: Bearer $GEOCODE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"kinds":{"digest":false}}'Example response
See the description above for what this returns.
Errors
Failures are RFC 9457 problems. Common ones here: 400 invalid_input, 401 unauthorized, 429 rate_limited.