> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.fortresstech.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.fortresstech.io/_mcp/server.

# lease.updated

POST 

Fortress POSTs this payload to the URL configured for your subscription. See
[Webhooks](/webhooks/webhooks) for delivery, signing and retry rules, and the
[event page](/webhooks/webhook-events/webhooks/lease-updated) for when it fires.


Reference: https://developer.fortresstech.io/api-reference/webhooks/on-lease-updated

## Request

### Payload

- `eventId` (string, required) — Unique identifier for this event. Stable across delivery attempts, so consumers must dedupe on this value. Also sent as the X-Fortress-Event-Id header.
- `eventType` (enum, required) — What happened, in resource.action form. Also sent as the X-Fortress-Event-Type header. New values are added over time.
  - Allowed values: `lease.updated`
- `occurredAt` (datetime, required) — ISO-8601 UTC timestamp of when the event occurred, not when it was delivered. A retried delivery carries the original occurredAt.
- `data` (LeaseUpdatedData, required) — Event payload. The shape is determined by eventType.
- `test` (boolean, optional) — Present, and true, only on a sample sent by the webhook trigger. A real delivery never carries it. It sits inside the signed body, unlike the X-Fortress-Test-Event header, so decide on this field.

## Types

### LeaseUpdatedData

Payload of a lease.updated event. It carries ids and the names of the changed fields only. Read the lease from GET /leases/\{leaseId}.

- `leaseId` (string, required) — The active lease that changed.
- `householdId` (string, required) — The household with the live subscription.
- `propertyId` (string, required) — The property of the household.
- `organizationId` (string, required) — The organization that owns the property.
- `changedFields` (list of enum, required) — The names of the lease fields that changed.
  - Allowed values: `startDate`, `endDate`, `rentAmount`, `unitId`
- `subscriptionIds` (list of string, required) — The live subscriptions of the household. Read each one with GET /subscriptions.