---
title: "Your product email and newsletter preferences"
method: GET
path: "/me/email-preferences"
tags: ["Account"]
---

# Your product email and newsletter preferences

`GET /me/email-preferences`

## Request

- Base URL: `https://adslighthouse.com/api/v1`
- URL: `https://adslighthouse.com/api/v1/me/email-preferences`
- Auth: HTTP bearer

Returns the email preferences of the person the credential acts for: optional product emails (tips, first-results and 80% usage notices) and the newsletter. Security, account, billing, service and alert emails are not optional. These preferences belong to the person, not the account.

## Response `200`

Your product email and newsletter preferences

- object
  - `email` string, required: The address these preferences apply to.
  - `product_emails` boolean, required: Optional product emails: getting-started tips, the first-results notice and the 80% usage notice.
  - `newsletter` 'subscribed' | 'pending' | 'unsubscribed' | 'none', required: Newsletter status. pending waits for the confirmation email; none means never subscribed.
  - `request_id` string

## Other responses

- `400`: Invalid parameters, cursor or body.
- `401`: Missing, invalid, expired or revoked credential.
- `403`: The credential lacks the write scope, the plan does not include the API, or the allowance is used up.
- `404`: Unknown project, keyword or run in this account.
- `409`: The idempotency key was already used for a different request.
- `429`: Rate limit reached. Retry after the Retry-After seconds.
- `503`: The requested service or file is temporarily unavailable.

---

[API](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api.md) · [All operations](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/revisions/e1a4a40b11a9?raw)