> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Record Delete | Webhook Events

> Fires when a custom object record is permanently deleted from an account.

The `RecordDelete` event fires whenever a custom object record is permanently removed from an account. The payload captures the record's state at the time of deletion, including its ID, property values, owners, and followers. Use this event to clean up related data in external systems, cascade deletions, or maintain deletion audit logs.

## Payload

| Field                | Type            | Description                                                                    |
| -------------------- | --------------- | ------------------------------------------------------------------------------ |
| `id`                 | `string`        | Unique identifier of the deleted record                                        |
| `locationId`         | `string`        | Account ID where the record existed                                            |
| `owners`             | `array<string>` | User IDs that were assigned as owners of this record at deletion time          |
| `followers`          | `array<string>` | User IDs that were following this record at deletion time                      |
| `properties`         | `array<object>` | Field values the record held at deletion time, each as a `{ key, value }` pair |
| `properties[].key`   | `string`        | The property key as defined in the object schema                               |
| `properties[].value` | `any`           | The value the property held at deletion time                                   |
| `timestamp`          | `string`        | ISO 8601 timestamp of when the deletion occurred                               |

## Example payload

```json theme={null}
{
  "id": "67a349a79b28947ec1f65bb5",
  "locationId": "eHy2cOSZxMQzQ6Yyvl8P",
  "owners": ["YlWd2wuCAZQzh2cH1fVZ"],
  "followers": [],
  "properties": [
    { "key": "pet_name", "value": "buddy" }
  ],
  "timestamp": "2024-04-01T00:00:00.000Z"
}
```

## Related

* [Record Create](/api-reference/webhooks/record-create) — fires when a new record is created
* [Objects API](/api-reference/objects/overview) — manage custom object schemas and records