> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# events_insert

> Create a calendar event; returns details of the event.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events"}</code></div>

```python gcalendar_events_insert.py theme={null}
from charter.packs import gcalendar

result = await gcalendar.events_insert.ainvoke({"calendarId": ..., "event": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/calendar.events`. Costs 1 against the provider's own quota.
</Note>

<Warning>
  This tool's JSON schema is 33 KB, because it models the whole resource this endpoint writes.
  That is more context than most tasks. Narrow it at the call site
  with [`Tool.derived`](/charter/charter/reference/tool#tool-derived):

  ```python theme={null}
  narrowed = gcalendar.events_insert.derived(
      name="events_insert_narrowed",
      drop={"event.conference_data", "event.attendees", "event.working_location_properties"},
  )
  ```

  Those are its heaviest branches by schema size, not a recommendation: which ones you can spare is yours to decide. The tool underneath is unchanged.
  See [Projections](/charter/charter/tools/projections).
</Warning>

## Path parameters

<div className="reference-table">
  | Field                                                              | Type     | Description                                                                                                                                                                             |
  | ------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `calendarId` <span className="required" title="required">\*</span> | `string` | Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword. |
</div>

## Query parameters

<div className="reference-table">
  | Field                   | Type                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                      |
  | ----------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `conferenceDataVersion` | `integer`                                                         | Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Version 1 enables support for copying of ConferenceData as well as for creating new conferences using the createRequest field of conferenceData. The default is 0. Acceptable values are 0 to 1, inclusive. <span className="field-constraints">≥ 0; ≤ 1</span>     |
  | `eventLabelVersion`     | `integer`                                                         | Version number of the event label feature supported by the API client. Version 0 assumes no event label support and processes the colorId field for color management. Version 1 enables support for event labels, and processes the eventLabelId in the event's body. In this case, the colorId field is ignored. The default is 0. Acceptable values are 0 to 1, inclusive. <span className="field-constraints">≥ 0; ≤ 1</span> |
  | `maxAttendees`          | `integer`                                                         | The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. <span className="field-constraints">≥ 1</span>                                                                                                                                                                                                                 |
  | `sendUpdates`           | [SendUpdates](/charter/charter/packs/gcalendar/event/objects#sendupdates) | Guests who should receive notifications about the change. Acceptable values are: "all" (notifications are sent to all guests), "externalOnly" (notifications are sent to non-Google Calendar guests only), "none" (no notifications are sent; for calendar migration tasks, consider using the Events.import method instead).                                                                                                    |
  | `supportsAttachments`   | `boolean`                                                         | Whether API client performing operation supports event attachments. Optional. The default is False.                                                                                                                                                                                                                                                                                                                              |
</div>

## Body

<div className="reference-table">
  | Field                                                         | Type                                                  | Description          |
  | ------------------------------------------------------------- | ----------------------------------------------------- | -------------------- |
  | `event` <span className="required" title="required">\*</span> | [Event](/charter/charter/packs/gcalendar/event/objects#event) | The event to insert. |
</div>