QEHSQEHS

Developer portal

record.deleted.v1

A record was soft-deleted.

record.deleted.v1v1at-least-once delivery

Fires when

On any deletion that sets deletedAt — GDPR deletion workflow or an admin delete action. Hard deletes (purge) fire record.purged.v1 instead.

Payload fields

Envelope fields are shared across all event types. Event-specific data is nested under data.

FieldTypeRequiredDescription
eventIdstring (uuid)requiredUnique per delivery attempt. Use for deduplication.
eventstringrequiredFully-qualified event name, e.g. record.created.v1.
tenantIdstring (uuid)requiredTenant that owns the affected resource.
firedAtstring (date-time)requiredISO-8601 UTC timestamp when the event was emitted.
data.recordIdstring (uuid)requiredID of the deleted record.
data.moduleKeystringrequiredComposer module key.
data.deletionRequestIdstring (uuid)optionalPresent when deletion was triggered by a GDPR deletion request.

Sample payload

{
  "eventId": "44444444-5555-6666-7777-888888888888",
  "event": "record.deleted.v1",
  "tenantId": "00000000-1111-2222-3333-444444444444",
  "firedAt": "2026-04-18T12:37:00.000Z",
  "data": {
    "recordId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "moduleKey": "incidents",
    "deletionRequestId": "bbbbbbbb-cccc-dddd-eeee-ffffffffffff"
  }
}

Verify the signature

Every delivery includes X-QEHS-Signature: sha256=<hex> and X-Job-ID headers. Verify before trusting the body. See the webhooks signature docs for a full verification example.