# Event

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Event/

Struct for a single event.

- **Full name:** `MFiles.Event`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-id"></a>`id` | `int64` | 1 | The ID of the event. |
| <a id="f-type"></a>`type` | [`EventType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.EventType/index.md) | 2 | The type of the event. |
| <a id="f-category"></a>`category` | [`EventCategory`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.EventCategory/index.md) | 3 | The category of the event. Values: `EVENT_CATEGORY_UNDEFINED` (0), `EVENT_CATEGORY_FILE_ACCESS` (1), `EVENT_CATEGORY_OBJECT_CHANGE` (2), `EVENT_CATEGORY_NEW_OBJECT` (3), `EVENT_CATEGORY_OBJECT_OPERATION` (4), `EVENT_CATEGORY_SYSTEM` (5), `EVENT_CATEGORY_REQUEST` (6), `EVENT_CATEGORY_METADATA_STRUCTURE_CHANGE` (7), `EVENT_CATEGORY_PUBLIC_LINK` (8), `EVENT_CATEGORY_CUSTOM_EVENT` (9). |
| <a id="f-timestamp_utc"></a>`timestamp_utc` | [`google.protobuf.Timestamp`](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp) | 4 | The timestamp of this event. |
| <a id="f-caused_by_user"></a>`caused_by_user` | `string` | 5 | The account name of the user whose activity lead to this event. If no user (this is a system operation), this is an empty string. |
| <a id="f-caused_by_user_full_name"></a>`caused_by_user_full_name` | `string` | 6 | The full name of the user whose activity lead to this event. If no user (this is a system operation), this is an empty string. |
| <a id="f-caused_by_user_id"></a>`caused_by_user_id` | `int32` | 11 | The ID of the user account whose activity lead to this event. If no user (this is a system operation), this is zero. |
| <a id="f-data"></a>`data` | [`EventTypeSpecificDataUnion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.EventTypeSpecificDataUnion/index.md) | 7 | Additional event type -specific data as a union. |
| <a id="f-notification_created"></a>`notification_created` | `bool` | 8 | Tells if the notifications have been created. |
| <a id="f-notification_object_info"></a>`notification_object_info` | [`DocumentInfoForNotifications`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.DocumentInfoForNotifications/index.md) | 9 | Document info. This is valid only until the notifications have been created. |
| <a id="f-xml_data"></a>`xml_data` | `string` | 10 | The data represented in XML. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCEventsAdmin.GetEvents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEventsAdmin/GetEvents/index.md): Gets all events of the vault.
- [IRPCEventsAdmin.GetEventsRange](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEventsAdmin/GetEventsRange/index.md): Gets events by ID range and filters, oldest or newest first, with an optional maximum count.

<a id="used-in-fields"></a>

## Used in fields

- [`GetEventsResponse.values`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEventsAdmin/GetEvents/index.md#response): The events, newest first. See [Event](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Event/index.md).
- [`GetEventsRangeResponse.events`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCEventsAdmin/GetEventsRange/index.md#response): The matching events. See [Event](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Event/index.md).