# Message.scheduled

URL: /business/events/Message.scheduled · Id: `event:Message.scheduled`

> Emitted each time a Message is scheduled.

[Message.schedule](/business/nouns/message/schedule) emits `Message.scheduled` when it completes on a [Message](/business/nouns/message).

| Property | Value |
| --- | --- |
| Emitted by | [Message.schedule](/business/nouns/message/schedule) |
| Noun | [Message](/business/nouns/message) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Message.schedule](/business/nouns/message/schedule) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Message.scheduled`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.message` | [Message](/business/nouns/message) | Yes | The scheduled Message. |
| `data.message.medium` | `string` | Yes | One of `email`, `sms`, `voice`, or `chat`. |
| `data.message.direction` | `string` | Yes | One of `inbound` or `outbound`. |
| `data.message.body` | `text` | Yes | What it says. |
| `data.message.from` | `string` | No | The sender: an address, a number, or a Channel id. |
| `data.message.to` | `string` | No | The recipient: an address, a number, or a Person id. |
| `data.message.subject` | `string` | No | The subject line, for email. |
| `data.message.purpose` | `string` | No | Why it goes out, such as onboarding; consent and suppression rules read it. |

### Example
```json
{
  "$id": "https://api.sb/routewise.dev/events/event_1",
  "$type": "Event",
  "name": "Message.scheduled",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "message": {
      "$id": "https://api.sb/routewise.dev/messages/message_1",
      "$type": "Message",
      "medium": "email",
      "direction": "inbound",
      "body": "Example body",
      "from": "Example from",
      "to": "Example to",
      "subject": "Example subject",
      "purpose": "Example purpose"
    }
  },
  "seq": 1
}
```