# Tenant.invited

URL: /business/events/Tenant.invited · Id: `event:Tenant.invited`

> Emitted each time a Tenant is invited.

[Tenant.invite](/business/nouns/tenant/invite) emits `Tenant.invited` when it completes on a [Tenant](/business/nouns/tenant).

| Property | Value |
| --- | --- |
| Emitted by | [Tenant.invite](/business/nouns/tenant/invite) |
| Noun | [Tenant](/business/nouns/tenant) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Tenant.invite](/business/nouns/tenant/invite) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Tenant.invited`. |
| `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.person` | [Person](/business/nouns/person) | Yes | The invited Person. |
| `data.tenant` | [Tenant](/business/nouns/tenant) | Yes | The Tenant the Person was invited to. |
| `data.tenant.placement` | `string` | No | Where the Tenant sits in an address: `path` or `host`. |
| `data.tenant.apiVersion` | `string` | No | The API version an unversioned call with this Tenant’s keys answers at; set at creation, moved only by `pin`. |

### Example
```json
{
  "$id": "https://api.sb/petpantry.shop/events/event_1",
  "$type": "Event",
  "name": "Tenant.invited",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "person": {
      "$id": "https://api.sb/petpantry.shop/people/person_1",
      "$type": "Person",
      "name": "Lena Fischer"
    },
    "tenant": {
      "$id": "https://api.sb/petpantry.shop/tenants/tenant_1",
      "$type": "Tenant",
      "placement": "path",
      "apiVersion": "v2"
    }
  },
  "seq": 1
}
```