---
title: "Typed events: intent, entities, urgency"
description: "Every inbound within your plan's limits becomes a structured event before your agent sees the body."
url: https://help.mails.ai/en/articles/10-typed-events-intent-entities-urgency
collection: "Inbound and events"
updated: 2026-10-10
language: en
---

# Typed events: intent, entities, urgency

Every inbound within your plan's limits becomes a structured event before your agent sees the body.

![Mails.ai — Typed events: intent, entities, urgency](https://staticfiles.gleap.io/p6a77ce6bbe980ea9dbca1955/zMPHlPdyURhA5OR6HsFJbAyzDxZdJk1fbLiWAgsk5nct9cj6RYrUnCNGjJw6FRD18Okk5PhwV9c.png)

An inbound does not arrive as raw text. It arrives as an event that already says how far to trust it: an injection score and a sender score. Switch on classification for an agent (`classify_inbound`, on the paid plans) and a first message from someone new also says what they want, what facts they named and how urgent it reads.

![One received email's event, quarantined: injection score 0.98 with its categories, the intent, urgency and the sender's reputation](https://staticfiles.gleap.io/p6a77ce6bbe980ea9dbca1955/EpQSctXSQv8iQTt52zGJNyuDDWEcSkt8lTrJbBBhsZ1RW0A7qvaZ0oz5AzbrRysswrgg0KCZTaM.png)

## What is on an inbound event

-   `intent` — what the message is trying to do, in one label. Filled in on a first message when classification is on, and `unclassified` when it is off; on a reply it is always `general_reply`.
    
-   `entities` — the facts pulled out of it, like a proposed time. Empty on a reply, and when classification is off.
    
-   `urgency` — 0 to 1 when classification is on; 0.5 on a reply.
    
-   `injection_score` — 0 to 1, with `injection_categories` listing what was flagged (empty when nothing was).
    
-   `sender_reputation` — a 0 to 1 trust score for this one message.
    
-   `extracted_text` — the message itself, quoted history removed.
    

## The full event list

These are the event types we actually emit — subscribing to anything else would create an endpoint that can never fire, so the API rejects it:

```
message.sent          message.received                   draft.scheduled
message.scheduled     message.received.unauthenticated   draft.sending
message.delivered     message.received.over_limit        draft.sent
message.delayed       reply.received                     draft.failed
message.bounced       suppression.added                  thread.created
message.complained    webhook.test                       thread.updated
message.failed                                           thread.deleted
```

A `*` subscription receives every type except `message.delayed` and the three thread events, which an endpoint gets only by naming them.

The Events page streams them live, which is the fastest way to watch what your agent is actually receiving while you build.

[Watch the event stream](https://app.mails.ai/events)
