Event catalog

Pastrata emits 87 catalogued events across 19 domains. Subscribe to the ones your extension needs in its manifest; each delivery arrives as a signed webhook.

Min scope — the scope your extension must be granted before the event is delivered to it. Scope is re-checked at send time, so a revoked consent stops delivery mid-flight rather than at the next install.

PII tier — how sensitive the payload is. Payloads are deliberately thin: ids plus a little denormalized context. Fetch detail through the Gateway under a scope check rather than expecting it inline.

Version — the payload contract version. Payloads evolve additively only: a schema may gain optional fields, and the version increments to signal that. A breaking change ships as a new event name, so a contract you have integrated against never changes shape underneath you.

Index

building

Event	Version	PII tier	Min scope
building.config.changed	1	NONE	BUILDING_SETTINGS_VIEW
building.unit.assigned	1	LOW	BUILDING_SETTINGS_VIEW
building.unit.created	1	LOW	BUILDING_SETTINGS_VIEW

calendar

Event	Version	PII tier	Min scope
calendar.event.cancelled	1	LOW	CALENDAR_VIEW
calendar.event.created	1	LOW	CALENDAR_VIEW
calendar.event.updated	1	LOW	CALENDAR_VIEW

community

Event	Version	PII tier	Min scope
community.poll.closed	1	LOW	FEED_MODERATE
community.post.created	1	LOW	FEED_MODERATE
community.post.deleted	1	LOW	FEED_MODERATE
community.report.created	1	LOW	FEED_MODERATE

concierge

Event	Version	PII tier	Min scope
concierge.guest_pass.issued	1	LOW	GUEST_PASS_MANAGE
concierge.guest_pass.revoked	1	LOW	GUEST_PASS_MANAGE
concierge.incident.created	1	LOW	INCIDENT_MANAGE
concierge.incident.resolved	1	LOW	INCIDENT_MANAGE
concierge.shift_note.recorded	1	LOW	SHIFT_NOTES
concierge.visitor.checked_in	1	LOW	VISITOR_MANAGE
concierge.visitor.checked_out	1	LOW	VISITOR_MANAGE

deposit

Event	Version	PII tier	Min scope
deposit.ledger.deducted	1	MODERATE	DEPOSIT_LEDGER_VIEW
deposit.ledger.recorded	1	LOW	DEPOSIT_LEDGER_VIEW
deposit.ledger.refunded	1	LOW	DEPOSIT_LEDGER_VIEW
deposit.ledger.transferred	1	LOW	DEPOSIT_LEDGER_VIEW

document

Event	Version	PII tier	Min scope
document.file.categorized	1	LOW	DOCUMENT_VIEW
document.file.deleted	1	LOW	DOCUMENT_VIEW
document.file.text_extracted	1	LOW	DOCUMENT_VIEW
document.file.uploaded	1	LOW	DOCUMENT_VIEW

extension

Event	Version	PII tier	Min scope
extension.installation.config_changed	1	NONE	EXTENSION_MANAGE
extension.installation.installed	1	NONE	EXTENSION_MANAGE
extension.installation.resumed	1	NONE	EXTENSION_MANAGE
extension.installation.suspended	1	NONE	EXTENSION_MANAGE
extension.installation.uninstalled	1	NONE	EXTENSION_MANAGE
extension.installation.upgraded	1	NONE	EXTENSION_MANAGE

inbox

Event	Version	PII tier	Min scope
inbox.request.assigned	1	LOW	INBOX_REQUEST_VIEW
inbox.request.created	1	LOW	INBOX_REQUEST_VIEW
inbox.request.reopened	1	LOW	INBOX_REQUEST_VIEW
inbox.request.resolved	1	LOW	INBOX_REQUEST_VIEW
inbox.request.routing_changed	1	LOW	INBOX_REQUEST_VIEW
inbox.request.status_changed	1	LOW	INBOX_REQUEST_VIEW

invitation

Event	Version	PII tier	Min scope
invitation.invite.accepted	1	LOW	DIRECTORY_VIEW
invitation.invite.sent	1	LOW	DIRECTORY_VIEW

leasing

Event	Version	PII tier	Min scope
leasing.lease.activated	1	LOW	LEASE_VIEW
leasing.lease.created	1	LOW	LEASE_VIEW
leasing.lease.sent	1	LOW	LEASE_VIEW
leasing.lease.signed	1	LOW	LEASE_VIEW
leasing.lease.terminated	1	LOW	LEASE_VIEW
leasing.move.completed	1	LOW	LEASE_VIEW
leasing.move.scheduled	1	LOW	LEASE_VIEW
leasing.renewal.accepted	1	LOW	LEASE_VIEW
leasing.renewal.declined	1	LOW	LEASE_VIEW
leasing.renewal.offered	1	LOW	LEASE_VIEW

legal

Event	Version	PII tier	Min scope
legal.agreement.cancelled	1	LOW	AGREEMENT_VIEW
legal.agreement.completed	1	LOW	AGREEMENT_VIEW
legal.agreement.declined	1	LOW	AGREEMENT_VIEW
legal.agreement.expired	1	LOW	AGREEMENT_VIEW
legal.agreement.partially_signed	1	LOW	AGREEMENT_VIEW
legal.agreement.sent	1	LOW	AGREEMENT_VIEW
legal.agreement.signed	1	LOW	AGREEMENT_VIEW
legal.prescribed_notice.acknowledged	1	LOW	PRESCRIBED_NOTICE_MANAGE
legal.prescribed_notice.generated	1	LOW	PRESCRIBED_NOTICE_MANAGE
legal.prescribed_notice.served	1	LOW	PRESCRIBED_NOTICE_MANAGE

meeting

Event	Version	PII tier	Min scope
meeting.meeting.cancelled	1	LOW	MEETING_ATTEND
meeting.meeting.created	1	LOW	MEETING_ATTEND
meeting.meeting.ended	1	LOW	MEETING_ATTEND
meeting.meeting.scheduled	1	LOW	MEETING_ATTEND
meeting.minutes.published	1	LOW	MEETING_ATTEND
meeting.motion.decided	1	LOW	MEETING_ATTEND
meeting.motion.proposed	1	LOW	MEETING_ATTEND

membership

Event	Version	PII tier	Min scope
membership.member.created	1	LOW	DIRECTORY_VIEW
membership.member.removed	1	LOW	DIRECTORY_VIEW
membership.member.role_changed	1	LOW	DIRECTORY_VIEW
membership.member.verified	1	LOW	DIRECTORY_VIEW

messaging

Event	Version	PII tier	Min scope
messaging.channel.created	1	LOW	CHANNEL_VIEW
messaging.conversation.created	1	LOW	MESSAGE_VIEW
messaging.message.sent	1	LOW	MESSAGE_VIEW

org

Event	Version	PII tier	Min scope
org.building.added	1	NONE	BUILDING_SETTINGS_VIEW
org.building.removed	1	NONE	BUILDING_SETTINGS_VIEW

package

Event	Version	PII tier	Min scope
package.parcel.logged	1	LOW	PACKAGE_VIEW
package.parcel.picked_up	1	LOW	PACKAGE_VIEW

pad

Event	Version	PII tier	Min scope
pad.mandate.enrolled	1	LOW	RENT_LEDGER_VIEW
pad.mandate.revoked	1	LOW	RENT_LEDGER_VIEW

payment

Event	Version	PII tier	Min scope
payment.transaction.failed	1	LOW	RENT_LEDGER_VIEW
payment.transaction.refunded	1	LOW	RENT_LEDGER_VIEW
payment.transaction.succeeded	1	LOW	RENT_LEDGER_VIEW

rent

Event	Version	PII tier	Min scope
rent.charge.created	1	LOW	RENT_LEDGER_VIEW
rent.charge.failed	1	LOW	RENT_LEDGER_VIEW
rent.charge.paid	1	LOW	RENT_LEDGER_VIEW
rent.charge.waived	1	MODERATE	RENT_LEDGER_VIEW
rent.charge.written_off	1	MODERATE	RENT_LEDGER_VIEW

Payloads

building.config.changed

Version 1 · PII tier NONE · requires BUILDING_SETTINGS_VIEW

Field	Type	Required	Description
changedKeys	string[]	yes	—

Example payload

{
  "changedKeys": [
    "booking.enabled",
    "feed.moderation"
  ]
}

building.unit.assigned

Version 1 · PII tier LOW · requires BUILDING_SETTINGS_VIEW

Field	Type	Required	Description
unitId	string	yes	—
membershipId	string \| null	yes	—
userId	string \| null	yes	—

Example payload

{
  "unitId": "unit_2",
  "membershipId": "mem_1",
  "userId": "usr_1"
}

building.unit.created

Version 1 · PII tier LOW · requires BUILDING_SETTINGS_VIEW

Field	Type	Required	Description
unitId	string	yes	—
label	string \| null	yes	—

Example payload

{
  "unitId": "unit_2",
  "label": "PH-1"
}

calendar.event.cancelled

Version 1 · PII tier LOW · requires CALENDAR_VIEW

Field	Type	Required	Description
eventId	string	yes	—

Example payload

{
  "eventId": "evt_1"
}

calendar.event.created

Version 1 · PII tier LOW · requires CALENDAR_VIEW

Field	Type	Required	Description
eventId	string	yes	—
startsAt	string	yes	—
endsAt	string \| null	yes	—

Example payload

{
  "eventId": "evt_1",
  "startsAt": "2026-08-01T17:00:00.000Z",
  "endsAt": "2026-08-01T18:00:00.000Z"
}

calendar.event.updated

Version 1 · PII tier LOW · requires CALENDAR_VIEW

Field	Type	Required	Description
eventId	string	yes	—
startsAt	string	yes	—
endsAt	string \| null	yes	—

Example payload

{
  "eventId": "evt_1",
  "startsAt": "2026-08-01T18:00:00.000Z",
  "endsAt": null
}

community.poll.closed

Version 1 · PII tier LOW · requires FEED_MODERATE

Field	Type	Required	Description
pollId	string	yes	—
postId	string	yes	—

Example payload

{
  "pollId": "poll_1",
  "postId": "post_1"
}

community.post.created

Version 1 · PII tier LOW · requires FEED_MODERATE

Field	Type	Required	Description
postId	string	yes	—
authorUserId	string \| null	yes	—
category	string \| null	yes	—
hasPoll	boolean	yes	—

Example payload

{
  "postId": "post_1",
  "authorUserId": "usr_1",
  "category": "ANNOUNCEMENT",
  "hasPoll": false
}

community.post.deleted

Version 1 · PII tier LOW · requires FEED_MODERATE

Field	Type	Required	Description
postId	string	yes	—
deletedBy	string	yes	—
deletedByUserId	string \| null	yes	—

Example payload

{
  "postId": "post_1",
  "deletedBy": "MODERATOR",
  "deletedByUserId": "usr_9"
}

community.report.created

Version 1 · PII tier LOW · requires FEED_MODERATE

Field	Type	Required	Description
reportId	string	yes	—
targetType	string	yes	—
targetPostId	string \| null	yes	—
targetCommentId	string \| null	yes	—

Example payload

{
  "reportId": "rep_1",
  "targetType": "POST",
  "targetPostId": "post_1",
  "targetCommentId": null
}

concierge.guest_pass.issued

Version 1 · PII tier LOW · requires GUEST_PASS_MANAGE

Field	Type	Required	Description
guestPassId	string	yes	—
unitId	string \| null	yes	—
purpose	string \| null	yes	—
validUntil	string \| null	yes	—

Example payload

{
  "guestPassId": "gp_1",
  "unitId": "unit_2",
  "purpose": "GUEST",
  "validUntil": "2026-08-02T00:00:00.000Z"
}

concierge.guest_pass.revoked

Version 1 · PII tier LOW · requires GUEST_PASS_MANAGE

Field	Type	Required	Description
guestPassId	string	yes	—
unitId	string \| null	yes	—

Example payload

{
  "guestPassId": "gp_1",
  "unitId": "unit_2"
}

concierge.incident.created

Version 1 · PII tier LOW · requires INCIDENT_MANAGE

Field	Type	Required	Description
incidentId	string	yes	—
category	string	yes	—
severity	string	yes	—

Example payload

{
  "incidentId": "inc_1",
  "category": "SECURITY",
  "severity": "HIGH"
}

concierge.incident.resolved

Version 1 · PII tier LOW · requires INCIDENT_MANAGE

Field	Type	Required	Description
incidentId	string	yes	—
resolvedByUserId	string \| null	yes	—

Example payload

{
  "incidentId": "inc_1",
  "resolvedByUserId": "usr_9"
}

concierge.shift_note.recorded

Version 1 · PII tier LOW · requires SHIFT_NOTES

Field	Type	Required	Description
shiftNoteId	string	yes	—
category	string	yes	—
authorId	string \| null	yes	—

Example payload

{
  "shiftNoteId": "sn_1",
  "category": "HANDOFF",
  "authorId": "usr_9"
}

concierge.visitor.checked_in

Version 1 · PII tier LOW · requires VISITOR_MANAGE

Field	Type	Required	Description
visitorId	string	yes	—
unitId	string \| null	yes	—
guestPassId	string \| null	yes	—
purpose	string \| null	yes	—

Example payload

{
  "visitorId": "vis_1",
  "unitId": "unit_2",
  "guestPassId": "gp_1",
  "purpose": "DELIVERY"
}

concierge.visitor.checked_out

Version 1 · PII tier LOW · requires VISITOR_MANAGE

Field	Type	Required	Description
visitorId	string	yes	—
unitId	string \| null	yes	—

Example payload

{
  "visitorId": "vis_1",
  "unitId": "unit_2"
}

deposit.ledger.deducted

Version 1 · PII tier MODERATE · requires DEPOSIT_LEDGER_VIEW

Field	Type	Required	Description
depositId	string	yes	—
amountCents	number	yes	—
reason	string \| null	yes	—

Example payload

{
  "depositId": "dep_1",
  "amountCents": 5000,
  "reason": "DAMAGE"
}

deposit.ledger.recorded

Version 1 · PII tier LOW · requires DEPOSIT_LEDGER_VIEW

Field	Type	Required	Description
depositId	string	yes	—
leaseId	string \| null	yes	—
amountCents	number	yes	—

Example payload

{
  "depositId": "dep_1",
  "leaseId": "lease_1",
  "amountCents": 105000
}

deposit.ledger.refunded

Version 1 · PII tier LOW · requires DEPOSIT_LEDGER_VIEW

Field	Type	Required	Description
depositId	string	yes	—
amountCents	number	yes	—

Example payload

{
  "depositId": "dep_1",
  "amountCents": 100000
}

deposit.ledger.transferred

Version 1 · PII tier LOW · requires DEPOSIT_LEDGER_VIEW

Field	Type	Required	Description
depositId	string	yes	—
leaseId	string \| null	yes	—
fromUserId	string \| null	yes	—
toUserId	string \| null	yes	—

Example payload

{
  "depositId": "dep_1",
  "leaseId": "lease_1",
  "fromUserId": "usr_1",
  "toUserId": "usr_2"
}

document.file.categorized

Version 1 · PII tier LOW · requires DOCUMENT_VIEW

Field	Type	Required	Description
documentId	string	yes	—
categoryId	string \| null	yes	—
previousCategoryId	string \| null	yes	—

Example payload

{
  "documentId": "doc_1",
  "categoryId": "cat_3",
  "previousCategoryId": null
}

document.file.deleted

Version 1 · PII tier LOW · requires DOCUMENT_VIEW

Field	Type	Required	Description
documentId	string	yes	—

Example payload

{
  "documentId": "doc_1"
}

document.file.text_extracted

Version 1 · PII tier LOW · requires DOCUMENT_VIEW

Field	Type	Required	Description
documentId	string	yes	—

Example payload

{
  "documentId": "doc_1"
}

document.file.uploaded

Version 1 · PII tier LOW · requires DOCUMENT_VIEW

Field	Type	Required	Description
documentId	string	yes	—
categoryId	string \| null	yes	—
mimeType	string \| null	yes	—

Example payload

{
  "documentId": "doc_1",
  "categoryId": "cat_3",
  "mimeType": "application/pdf"
}

extension.installation.config_changed

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "scopeType": "BUILDING",
  "scopeId": "bld_1"
}

extension.installation.installed

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
versionId	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "versionId": "ver_1",
  "scopeType": "BUILDING",
  "scopeId": "bld_1"
}

extension.installation.resumed

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "scopeType": "BUILDING",
  "scopeId": "bld_1"
}

extension.installation.suspended

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—
reason	string \| null	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "scopeType": "BUILDING",
  "scopeId": "bld_1",
  "reason": "billing hold"
}

extension.installation.uninstalled

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "scopeType": "BUILDING",
  "scopeId": "bld_1"
}

extension.installation.upgraded

Version 1 · PII tier NONE · requires EXTENSION_MANAGE

Field	Type	Required	Description
installationId	string	yes	—
extensionId	string	yes	—
extensionSlug	string	yes	—
scopeType	BUILDING \| MANAGEMENT_ORG \| JURISDICTION \| GLOBAL	yes	—
scopeId	string	yes	—
fromVersionId	string	yes	—
toVersionId	string	yes	—

Example payload

{
  "installationId": "inst_1",
  "extensionId": "ext_1",
  "extensionSlug": "acme-screening",
  "scopeType": "BUILDING",
  "scopeId": "bld_1",
  "fromVersionId": "ver_1",
  "toVersionId": "ver_2"
}

inbox.request.assigned

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—
assigneeUserId	string \| null	yes	—

Example payload

{
  "requestId": "req_1",
  "assigneeUserId": "usr_9"
}

inbox.request.created

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—
status	string	yes	—
category	string \| null	yes	—

Example payload

{
  "requestId": "req_1",
  "status": "OPEN",
  "category": "PLUMBING"
}

inbox.request.reopened

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—

Example payload

{
  "requestId": "req_1"
}

inbox.request.resolved

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—
resolution	string \| null	yes	—

Example payload

{
  "requestId": "req_1",
  "resolution": "RESOLVED"
}

inbox.request.routing_changed

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—
previousRoutingMode	string	yes	—
routingMode	string	yes	—

Example payload

{
  "requestId": "req_1",
  "previousRoutingMode": "NORMAL",
  "routingMode": "ESCALATED_PMC"
}

inbox.request.status_changed

Version 1 · PII tier LOW · requires INBOX_REQUEST_VIEW

Field	Type	Required	Description
requestId	string	yes	—
previousStatus	string	yes	—
status	string	yes	—

Example payload

{
  "requestId": "req_1",
  "previousStatus": "OPEN",
  "status": "IN_PROGRESS"
}

invitation.invite.accepted

Version 1 · PII tier LOW · requires DIRECTORY_VIEW

Field	Type	Required	Description
invitationId	string	yes	—
membershipId	string	yes	—
userId	string	yes	—

Example payload

{
  "invitationId": "inv_1",
  "membershipId": "mem_1",
  "userId": "usr_1"
}

invitation.invite.sent

Version 1 · PII tier LOW · requires DIRECTORY_VIEW

Field	Type	Required	Description
invitationId	string	yes	—
unitId	string \| null	yes	—

Example payload

{
  "invitationId": "inv_1",
  "unitId": "unit_2"
}