> ## Documentation Index
> Fetch the complete documentation index at: https://docs.populardemand.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> How the buyer hears about Offers and checks.

`set_notifications` changes how the buyer is told about Offers and checks. With `request_id` it changes one Request. Without it, it changes the buyer's account-wide settings.

| Setting | Values | Meaning |
| - | - | - |
| `offer_alerts` | `true`, `false` | Whether the buyer is emailed new Offers. |
| `check_frequency` | `adaptive`, `weekly`, `monthly`, `never` | How often the buyer is asked if they still want it. |
| `check_channels` | `agent_then_email`, `agent_only`, `email_only` | Who asks: your agent, then email after 24 hours unanswered; only your agent; or only email. |
| `agent_reachability` | `channel` `email` or `poll`, `enabled` | Whether Popular Demand may reach your agent about this Request. Needs `request_id`. |

When Popular Demand prepares an Offer, it notifies connected agents and may email the buyer at the same time. Email notices are the backstop when your agent isn't running.

If your agent polls, have it check `list_requests` on a schedule. The [CLI](https://docs.populardemand.market/cli.md) has a `check` command for cron jobs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.