# Prospect.engaged

URL: /business/events/Prospect.engaged · Id: `event:Prospect.engaged`

> Emitted each time a Prospect is engaged.

[Prospect.engage](/business/nouns/prospect/engage) emits `Prospect.engaged` when it completes on a [Prospect](/business/nouns/prospect).

| Property | Value |
| --- | --- |
| Emitted by | [Prospect.engage](/business/nouns/prospect/engage) |
| Noun | [Prospect](/business/nouns/prospect) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Prospect.engage](/business/nouns/prospect/engage) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Prospect.engaged`. |
| `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.lead` | [Lead](/business/nouns/lead) | Yes | The new Lead, with status `new` and the Prospect’s Acquisition. |
| `data.prospect` | [Prospect](/business/nouns/prospect) | Yes | The Prospect who engaged. |
| `data.prospect.foundIn` | `string` | Yes | Where the Startup found them. |
| `data.prospect.basis` | `string` | Yes | The legal basis for contacting them. |

### Example
```json
{
  "$id": "https://api.sb/petpantry.shop/events/event_1",
  "$type": "Event",
  "name": "Prospect.engaged",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "lead": {
      "$id": "https://api.sb/petpantry.shop/leads/lead_1",
      "$type": "Lead",
      "status": "new"
    },
    "prospect": {
      "$id": "https://api.sb/petpantry.shop/prospects/prospect_1",
      "$type": "Prospect",
      "foundIn": "Example found in",
      "basis": "Example basis"
    }
  },
  "seq": 1
}
```