--- title: "Calendar Event Updated" method: POST path: "webhooks_events_calendarEventUpdated" --- # Calendar Event Updated `POST webhooks_events_calendarEventUpdated` (webhook) ## Headers - `svix-id` string, required: ID of webhook message. - `svix-signature` string, required: Signature of webhook message. - `svix-timestamp` string, date-time, required: Timestamp of webhook message. ## Payload - EventsCalendarEventUpdatedEvent: An event, or one or more dates of a recurring event, changed. `calendar_event` is the event (or the date) after the change. Cancelling dates with a delete on a dated ID also sends this event, with the cancelled date as `calendar_event`. - `type` 'event', required - `event_type` 'calendar.event.updated', required - `event_id` string, required: ID of the event. It is the same on every retry and redelivery of the event and on every webhook or WebSocket subscription that receives it, so use it to deduplicate. The format varies by event type; treat it as an opaque string. - `inbox_id` string, required: The ID of the inbox. - `calendar_event` CalendarCalendarEvent, required: A calendar event. The same shape is used by every response, list item and webhook. `kind` says whether it is a one-off event, the definition of a recurring series, or one date of a series. - `event_id` string, required: ID of a calendar event. A one-off or recurring event is addressed by its UUID. One date of a recurring event is addressed by a dated ID, `_`: `_t20261015T090000` for a timed date (the original wall-clock start in the event's time zone) or `_d20261015` for an all-day date. Dated IDs are stable: moving a date keeps its original ID. - `kind` 'single' | 'series' | 'instance', required: What the event object represents. - `single`: a one-off event, addressed by its UUID. - `series`: the definition of a recurring event, addressed by its UUID. It carries `recurrence`; `start` and `end` describe its first date. - `instance`: one date of a recurring event, addressed by its dated ID. It carries `series_id`, `original_start` and `is_exception`. - `series_id` string: For `instance` events, the UUID of the series this date belongs to. - `original_start` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `original_start_at` string, date-time: For `instance` events, `original_start` as a UTC instant. - `is_exception` boolean: For `instance` events, `true` when this date was edited or moved, individually or by a `mode=future` change. - `title` string, required: Title of the event. - `description` string: Description of the event. Omitted from agenda and instance list items. - `location` string: Location of the event. - `metadata` unknown - `status` 'confirmed' | 'tentative' | 'cancelled', required: Status of the event. A `cancelled` event or date stays readable but sends no `calendar.event.starting` or `calendar.event.ending` webhooks (cancelling a date that is already running still sends its `calendar.event.ending`). A date cancelled by deleting its dated ID is removed from the series instead, so reading it can return `404` or `410`. - `all_day` boolean, required: Whether this is an all-day event. - `start` string, required: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `end` string, required: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `timezone` string, required: IANA time zone name, for example `America/New_York`, `Europe/London` or `UTC`. Requests accept any capitalization and IANA aliases such as `US/Eastern`. The calendar stores and returns the canonical name, which for some zones is an older spelling: `Asia/Kolkata` is returned as `Asia/Calcutta`. Abbreviations such as `PST` and Windows names such as `Pacific Standard Time` are rejected. - `duration_mode` 'nominal' | 'exact', required: How the event's length is kept when a date crosses a daylight-saving change. - `exact`: the event lasts the same elapsed time. Default for one-off timed events. - `nominal`: the event keeps its wall-clock end time (a 09:00 to 10:00 meeting stays 09:00 to 10:00 local time). Default for recurring timed events. All-day events are always `nominal`. - `duration_value` integer, required: Length of the event, in milliseconds for timed events and in days for all-day events. - `start_at` string, date-time, required: Start as a UTC instant. This is when `calendar.event.starting` is due. - `end_at` string, date-time, required: End as a UTC instant. This is when `calendar.event.ending` is due. - `recurrence` CalendarRecurrence: The recurrence of a series, as stored. - `rule` string, required: Normalized RRULE body, without the `RRULE:` prefix. - `exdates` CalendarWallTime[] - `rdates` CalendarRecurrenceDate[] - union: A wall-clock date or date-time, or (timed events only) a period. - string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - CalendarRecurrencePeriod: An extra date (RDATE) given as a period. Specify exactly one of `end` or `duration`. - `start` string, required: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `end` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `duration` string: ISO 8601 duration, for example `PT30M`. - `truncate_before` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `attendees` CalendarAttendee[]: Attendees of the event. Omitted from agenda and instance list items; `attendee_count` is always present. - `email` string, required: Email address of the attendee. Stored in lowercase. Must be unique within the event. - `name` string: Display name of the attendee. At most 256 characters. - `status` 'needs_action' | 'accepted' | 'declined' | 'tentative': The attendee's response to the invitation. - `role` 'required' | 'optional': Whether the attendee's presence is required. - `comment` string: Comment the attendee sent with their response. At most 4,096 UTF-8 bytes; on create or update, a longer comment is dropped rather than rejected. - `responded_at` string, date-time: Time at which the attendee last responded. - `attendee_count` integer, required: Number of attendees. - `response_status` 'needs_action' | 'accepted' | 'declined' | 'tentative': The attendee's response to the invitation. - `uid` string, required: iCalendar UID of the event. Invitations about this event carry the same UID. - `sequence` integer, required: iCalendar SEQUENCE number. It increases when a change to a one-off or series event affects what attendees see (time, status, title, description, location, recurrence or attendees). A change to a dated event increases it only when the change is sent with `send_invites`. - `source` 'api' | 'email', required: Where the event came from. `api` events were created through this API and the inbox is their organizer. `email` events were created from a calendar invitation (iMIP) received by the inbox; their organizer is the sender of the invitation. - `organizer_email` string: Email address of the organizer. For `api` events, the inbox. - `origin_message_id` string: For `email` events, the ID of the message whose invitation last created or updated the event. - `resource_revision` integer: Revision of the resource. It increases on every change. The resource's `etag` is `"rv-"`. - `created_at` string, date-time, required: Time at which the event (or, for a date, the definition governing it) was created. - `updated_at` string, date-time, required: Time at which the event (or, for a date, the definition governing it) was last updated. - `etag` string: The event's or date's current version, also sent as the `ETag` response header. Send it in `If-Match` to make an update, delete or response conditional. Present on Get, Create, Update, Delete and Respond responses; list items and webhooks omit it. Treat it as opaque: a dated event's `etag` (`"occ-..."`) is not derived from `resource_revision`. - `previous` EventsCalendarEventPrevious: The values that a `calendar.event.updated` change replaced, for the fields it changed. Only changed fields appear; a field that had no value before the change is absent. - `title` string - `description` string - `location` string - `metadata` unknown - `status` 'confirmed' | 'tentative' | 'cancelled': Status of the event. A `cancelled` event or date stays readable but sends no `calendar.event.starting` or `calendar.event.ending` webhooks (cancelling a date that is already running still sends its `calendar.event.ending`). A date cancelled by deleting its dated ID is removed from the series instead, so reading it can return `404` or `410`. - `all_day` boolean - `start` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `end` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `timezone` string: IANA time zone name, for example `America/New_York`, `Europe/London` or `UTC`. Requests accept any capitalization and IANA aliases such as `US/Eastern`. The calendar stores and returns the canonical name, which for some zones is an older spelling: `Asia/Kolkata` is returned as `Asia/Calcutta`. Abbreviations such as `PST` and Windows names such as `Pacific Standard Time` are rejected. - `duration_mode` 'nominal' | 'exact': How the event's length is kept when a date crosses a daylight-saving change. - `exact`: the event lasts the same elapsed time. Default for one-off timed events. - `nominal`: the event keeps its wall-clock end time (a 09:00 to 10:00 meeting stays 09:00 to 10:00 local time). Default for recurring timed events. All-day events are always `nominal`. - `recurrence` CalendarRecurrence: The recurrence of a series, as stored. - `rule` string, required: Normalized RRULE body, without the `RRULE:` prefix. - `exdates` CalendarWallTime[] - `rdates` CalendarRecurrenceDate[] - union: A wall-clock date or date-time, or (timed events only) a period. - string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - CalendarRecurrencePeriod: An extra date (RDATE) given as a period. Specify exactly one of `end` or `duration`. - `start` string, required: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `end` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `duration` string: ISO 8601 duration, for example `PT30M`. - `truncate_before` string: A local wall-clock time without an offset, interpreted in the event's `timezone`. Timed events use `YYYY-MM-DDTHH:mm:ss` (for example `2026-10-15T09:00:00`). All-day events use `YYYY-MM-DD`. Years must be between 1900 and 9999. - `attendees` CalendarAttendee[] - `email` string, required: Email address of the attendee. Stored in lowercase. Must be unique within the event. - `name` string: Display name of the attendee. At most 256 characters. - `status` 'needs_action' | 'accepted' | 'declined' | 'tentative': The attendee's response to the invitation. - `role` 'required' | 'optional': Whether the attendee's presence is required. - `comment` string: Comment the attendee sent with their response. At most 4,096 UTF-8 bytes; on create or update, a longer comment is dropped rather than rejected. - `responded_at` string, date-time: Time at which the attendee last responded. ## Acknowledgement `200` Webhook received successfully --- [API](https://skmtc.dev/agentmail-to/apis/api.md) - [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentmail-to/apis/api/revisions/a9792efe7bdf?raw)