> 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.

# customer.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/customer-updated) for when it fires.


Reference: https://developer.fortresstech.io/api-reference/webhooks/on-customer-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: `customer.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` (CustomerUpdatedData, 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

### CustomerUpdatedData

Payload of a customer.updated event. It carries ids and the names of the changed fields only, never names, contact data or identifiers. Read the customer from GET /customers/\{customerId}.

- `customerId` (string, required) — The customer who 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 customer fields that changed.
  - Allowed values: `firstName`, `lastName`, `email`, `phone`, `dob`, `ssn`
- `subscriptionIds` (list of string, required) — The live subscriptions of the household. Read each one with GET /subscriptions.