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

# Webhook events

> Every webhook event Quotable sends, when it fires, and the exact payload it carries.

Quotable sends one event type. Every delivery wraps its `data` in the same [envelope](https://docs.usequotable.com/webhooks/overview.md#the-envelope); the examples below show the full body your endpoint receives.

| Event | Sent when | `resource.type` |
| - | - | - |
| [`tracking.run.finalized`](#tracking-run-finalized) | A day's tracking for a brand was scored | `project` |

Fetching the record behind `resource.href` requires an API key with the `read:projects` scope.

> [!NOTE]
>
> Older endpoints may still list `article.published`, `article.publish_failed` or `content.run.finished` among their events. Quotable no longer sends these, so you can ignore them.

## tracking.run.finalized

Sent when a day's tracking for a brand has been scored and the results are visible in the app and the API.

```json theme={"system"}
{
  "id": "5d1e7a3c-2b4f-4c6e-8a0d-9f1b3c5e7a20",
  "type": "tracking.run.finalized",
  "schema_version": 1,
  "occurred_at": "2026-10-01T10:00:45.112Z",
  "org_id": "8f3c2a1e-5b7d-4e9a-9c1f-2d6b8a4e7f10",
  "project_id": "c4a1e8f2-7d3b-4c6a-9e5f-1b2d3c4e5f60",
  "resource": {
    "type": "project",
    "id": "c4a1e8f2-7d3b-4c6a-9e5f-1b2d3c4e5f60",
    "href": "https://app.usequotable.com/api/v1/projects/c4a1e8f2-7d3b-4c6a-9e5f-1b2d3c4e5f60"
  },
  "data": {
    "run_date": "2026-10-01",
    "score": 43.8,
    "mention_rate": 0.6111111111111112,
    "answers_scored": 36
  }
}
```

| `data` field | Type | Meaning |
| - | - | - |
| `run_date` | `YYYY-MM-DD` | The tracking day that was scored. |
| `score` | number | The visibility score for that day, from 0 to 100, rounded to two decimals. |
| `mention_rate` | number | The share of answers that mention the brand, from 0 to 1. Not rounded. |
| `answers_scored` | integer | How many AI answers were scored. |

The values match the `score` and `mention_rate` for the same `date` in `GET /projects/{project_id}/visibility`. Call that endpoint for share of voice and the rest of the series.

> [!NOTE]
>
> A run can be scored more than once, for example when late answers arrive and the day is re-scored. Each event carries the latest values, so store them keyed by `project_id` and `run_date` and let a newer event overwrite an older one.

## Payload versioning

`schema_version` is `1` for every event. It changes only for an incompatible change to an event's payload. New fields can be added to `data` or the envelope at any time without a version change, so ignore fields you don't recognize.

## Next steps

> [card] [Verify signatures](https://docs.usequotable.com/webhooks/verify-signatures.md)
>
> Prove each delivery came from Quotable before you act on it.

> [card] [Delivery and retries](https://docs.usequotable.com/webhooks/delivery-and-retries.md)
>
> Retry schedule, ordering and deduplication.


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