---
title: "Digest events"
description: "What a daily rule sends once a day."
canonical: https://docs.mentio.dev/webhooks/digest-events
markdown: https://docs.mentio.dev/webhooks/digest-events.mdx
---

# Digest events

What a daily rule sends once a day.

A `daily` rule sends one request per day, at `schedule.hour` and `schedule.minute` in `schedule.timezone`, covering the mentions since the previous digest that pass the rule's filter. With `schedule.skipEmpty` on (the default) a day with nothing matched sends nothing. `POST /v1/alerts/{id}/run` sends the last 24 hours immediately, same shape, without moving the schedule.

`event` is `digest` unless the rule sets its own name.

```json
{
  "id": "dlv_4e0b...",
  "event": "digest",
  "createdAt": "2026-09-03T07:00:12.481Z",
  "alert": { "id": "feed_8a91...", "name": "Morning digest" },
  "data": {
    "window": { "from": "2026-09-02T07:00:00.000Z", "to": "2026-09-03T07:00:00.000Z" },
    "matched": 42,
    "relevant": 17,
    "previousMatched": 30,
    "byPlatform": [
      { "platform": "hackernews", "count": 12 },
      { "platform": "reddit", "count": 5 }
    ],
    "sentiment": { "positive": 9, "neutral": 6, "negative": 2 },
    "top": [ { "id": "mm_7f3a...", "status": "open", "relevant": true, "...": "..." } ],
    "negative": [ { "...": "..." } ],
    "buyIntent": [ { "...": "..." } ],
    "questions": [ { "...": "..." } ]
  }
}
```

## Fields

| Field             | Meaning                                                                                |
| ----------------- | -------------------------------------------------------------------------------------- |
| `window`          | The period covered, ISO 8601 UTC                                                       |
| `matched`         | Everything the rule matched in the window, relevant or not (the number billing counts) |
| `relevant`        | Of those, scored at or above the relevance threshold                                   |
| `previousMatched` | `matched` for the same rule over the window right before this one                      |
| `byPlatform`      | Matched count per platform, most first                                                 |
| `sentiment`       | Relevant mentions by sentiment                                                         |
| `top`             | Up to 10 relevant, undismissed mentions, best first by `priority`                      |
| `negative`        | Up to 5 relevant negative mentions                                                     |
| `buyIntent`       | Up to 5 relevant mentions with buying intent                                           |
| `questions`       | Up to 5 relevant questions                                                             |

Every entry in `top`, `negative`, `buyIntent` and `questions` is a full [Mention](/api/mentions/get-mention), the same shape an instant rule sends under `data`. A mention can appear in more than one list.

Retries and signature verification are covered in [Webhooks](/webhooks).