# event.updated

Source: https://developer.nylas.com/docs/reference/notifications/events/event-updated/

Sent when an event is modified or updated. Includes the `occurrences` parameter if the updated event is a single occurrence of a recurring Google event.

> If you have field customization enabled, the notification type will include a `.transformed` suffix (e.g. `event.updated.transformed`). Your endpoint must handle both the standard and suffixed types.

## data.object fields

- `account_id` (string) - Legacy Nylas v2 account identifier (deprecated).
- `busy` (boolean, nullable) - Whether the event marks the user as busy. May be `null` if not set by the provider.
- `calendar_id` (string, nullable) **(required)** - Identifier for the calendar this event belongs to. May be `null` in rare edge cases.
- `cancelled_occurrences` (array) - Event IDs of cancelled occurrences in a recurring series.
- `conferencing` (object) - Video conferencing details attached to the event.
  - `details` (object) - Provider-specific conferencing details.
    - `url` (string) - URL to join the meeting.
  - `provider` (string) - Conferencing provider name.
- `created_at` (integer) - Unix timestamp when the event was created.
- `description` (string) - Event description.
- `grant_id` (string) - Unique identifier for the grant that owns this event.
- `hide_participants` (boolean) - Whether the participant list is hidden from attendees.
- `html_link` (string) - URL to view the event in the provider's web interface.
- `ical_uid` (string) - Unique iCalendar identifier for the event.
- `id` (string) **(required)** - Unique identifier for the event.
- `location` (string) - Location of the event.
- `object` (string) **(required)** (event) - Object type identifier.
- `metadata` (object) - Key-value pairs of custom metadata attached to the event.
- `occurrences` (array) - Event IDs of modified occurrences in a recurring series (Google only). Omitted when not applicable.
- `organizer` (object) - The organizer of the event.
  - `email` (string) - Organizer's email address.
  - `name` (string) - Organizer's display name.
- `participants` (array) - List of event participants.
  - `email` (string) - Participant's email address.
  - `name` (string) - Participant's display name.
  - `status` (string) (yes, no, maybe, noreply) - RSVP status of the participant.
- `read_only` (boolean) - Whether the event is read-only for the authenticated user.
- `recurrence` (array) - RRULE strings defining the recurrence pattern.
- `reminders` (object) - Reminder settings for the event.
  - `overrides` (array) - Custom reminder overrides.
  - `use_default` (boolean) - Whether to use the calendar's default reminders.
- `resources` (array) - Resources (rooms, equipment) booked for the event.
- `status` (string) (confirmed, tentative, cancelled) - Confirmation status of the event.
- `title` (string) - Title of the event.
- `updated_at` (integer) - Unix timestamp when the event was last updated.
- `visibility` (string) (default, public, private, confidential) - Visibility of the event.
- `when` (object) **(required)** - Time details for the event. The fields present depend on the `object` subtype: `timespan` has `start_time`/`end_time`/`start_timezone`/`end_timezone`; `datespan` has `start_date`/`end_date`; `date` has `date`; `time` has `time`/`timezone`.
  - `object` (string) (timespan, datespan, date, time) - Time object type.
  - `start_time` (integer) - Unix timestamp when the event starts. Present for `timespan`.
  - `end_time` (integer) - Unix timestamp when the event ends. Present for `timespan`.
  - `start_timezone` (string) - IANA timezone for the start time. Present for `timespan`.
  - `end_timezone` (string) - IANA timezone for the end time. Present for `timespan`.
  - `start_date` (string) - Start date in `YYYY-MM-DD` format. Present for `datespan`.
  - `end_date` (string) - End date in `YYYY-MM-DD` format. Present for `datespan`.
  - `date` (string) - Date in `YYYY-MM-DD` format. Present for `date`.
  - `time` (integer) - Unix timestamp for a point-in-time event. Present for `time`.
  - `timezone` (string) - IANA timezone. Present for `time`.

## Example payload

```json
{
  "specversion": "1.0",
  "type": "event.updated",
  "source": "/google/events/realtime",
  "id": "<WEBHOOK_ID>",
  "time": 1732575192,
  "webhook_delivery_attempt": 1,
  "data": {
    "application_id": "<NYLAS_APPLICATION_ID>",
    "object": {
      "account_id": "<NYLAS_V2_ACCOUNT_ID>",
      "busy": true,
      "calendar_id": "<CALENDAR_ID>",
      "cancelled_occurrences": [
        "<EVENT_ID>"
      ],
      "conferencing": {
        "details": {
          "url": "<MEETING_URL>"
        },
        "provider": "<PROVIDER>"
      },
      "created_at": 1732573232,
      "description": "Weekly one-on-one.",
      "grant_id": "<NYLAS_GRANT_ID>",
      "hide_participants": false,
      "html_link": "<EVENT_LINK>",
      "ical_uid": "<ICAL_UID>",
      "id": "<EVENT_ID>",
      "location": "Room 103",
      "object": "event",
      "metadata": {
        "key1": "all-meetings",
        "key2": "on-site"
      },
      "organizer": {
        "email": "nyla@example.com",
        "name": "Nyla"
      },
      "participants": [
        {
          "email": "leyahe@example.com",
          "name": "Leyah Miller",
          "status": "noreply"
        }
      ],
      "read_only": false,
      "recurrence": [
        "RRULE:FREQ=WEEKLY;UNTIL=20241219T000000Z;BYDAY=TH"
      ],
      "reminders": {
        "overrides": [],
        "use_default": true
      },
      "resources": [],
      "status": "confirmed",
      "title": "One-on-one",
      "updated_at": 1732575179,
      "visibility": "public",
      "when": {
        "end_time": 1732811400,
        "end_timezone": "EST5EDT",
        "object": "timespan",
        "start_time": 1732809600,
        "start_timezone": "EST5EDT"
      }
    }
  }
}
```