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

# Notifications

> Choose which emails Itoflow sends you, and check what was sent.

> [!TIP]
>
> **The easiest way: ask your AI assistant.** With [Itoflow MCP](https://docs.itoflow.ai/mcp/install.md) connected to Claude or Codex, paste:
>
> ```text theme={null}
> Use Itoflow to show my email notification settings, then turn off emails for
> finished strategy runs.
> ```
>
> > [card] [Open in Claude](https://claude.ai/new?q=Use%20the%20Itoflow%20plugin%20\(https%3A%2F%2Fgithub.com%2Fitoflow%2Fskills\)%20for%20this.%20If%20it%20isn't%20installed%20yet%2C%20first%20tell%20me%20how%20to%20install%20it%20and%20sign%20in%20to%20Itoflow%2C%20and%20wait%20until%20I%20confirm.%20Then%3A%0A%0AUse%20Itoflow%20to%20show%20my%20email%20notification%20settings%2C%20then%20turn%20off%20emails%20for%20finished%20strategy%20runs.)
> >
> > Start this in Claude with the Itoflow plugin.
>
> > [card] [Open in ChatGPT](https://chatgpt.com/?q=Use%20the%20Itoflow%20plugin%20\(https%3A%2F%2Fgithub.com%2Fitoflow%2Fskills\)%20for%20this.%20If%20it%20isn't%20installed%20yet%2C%20first%20tell%20me%20how%20to%20install%20it%20and%20sign%20in%20to%20Itoflow%2C%20and%20wait%20until%20I%20confirm.%20Then%3A%0A%0AUse%20Itoflow%20to%20show%20my%20email%20notification%20settings%2C%20then%20turn%20off%20emails%20for%20finished%20strategy%20runs.)
> >
> > Start this in ChatGPT with the Itoflow plugin.
>
> Using another client? Copy the prompt with the button on the code block.
>
> No tokens or code needed. You can also do this in the [Itoflow app](https://app.itoflow.ai/account). The rest of this page covers the HTTP API.

Itoflow emails you about events on your account, such as a finished strategy run or a trade waiting for approval. You choose which ones you get, in your [account settings](https://app.itoflow.ai/account) or with the API.

## Preferences

`GET /notifications/preferences` returns your `preferences`: one entry per event, each with an `email` true or false.

`PUT /notifications/preferences` changes only the events you send; the rest keep their settings.

| Event key | Sent when |
| - | - |
| `strategy_execution` | A strategy run finishes |
| `pending_approval` | Trades are waiting for your approval |
| `broker_reconnect_required` | A broker connection needs reconnecting |
| `welcome` | The founder check-in, scheduled for the next day |

There are also billing events for usage warnings, running out of credits, overage and reaching your spending cap. `GET /notifications/preferences` lists their keys.

## Strategy emails

Strategy emails use the recorded decision total, including cash reserved for
pending buys. A holding without a stored weight uses its value divided by that
total. An open line without a usable price, currency or exchange rate makes the
total, each weight and each holding's value read as a dash (—).

A decision notification still arrives when a figure is not known: today's
return, the cumulative return or the portfolio value. The email shows a dash
(—) for that figure. It never reports zero, and it does not give the reason,
because you cannot act on it. Itoflow records a short reason code for
support. The
decision's other metrics, holdings and trades are unchanged. Strategy-run,
approval and reminder notices all follow this rule.

Today's return is the decision's own day only. When the portfolio's last
recorded value is from an earlier day, the field shows a dash. A reminder sent
on a later day labels the return with the day it belongs to, not “Today”. A
decision also gets its notice when a holding has no usable price or no
performance has been calculated yet; the value or returns then show a dash.

## Delivery history

`GET /notifications/logs` lists emails Itoflow tried to send, with a status and time for each. Check the status: an entry can be a failed attempt, and even a sent email may not have arrived or been read.

The founder’s “Checking in” email waits 24 hours after the email provider accepts
its schedule. A `queued` entry with a provider message ID records an accepted
schedule, not delivery. You do not need to sign in again to receive it.

`POST /notifications/unsubscribe` turns off all optional emails for your account. It needs an access token.

See the [notification endpoint reference](https://docs.itoflow.ai/api-reference/coverage.md#notifications).


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