> ## 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_quick_add

> Create an event from a plain-text description such as 'Appointment at Somewhere on June 3rd 10am-10:25am'. Google parses the time and title; use events_insert when the fields are already known.

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

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

result = await gcalendar.events_quick_add.ainvoke({"calendarId": ..., "text": ...})
```

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

## 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                                                                                                                                                                                                                                                                                                                   |
  | ------------------------------------------------------------ | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `text` <span className="required" title="required">\*</span> | `string`                                                          | The text describing the event to be created. <span className="field-constraints">min length 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). |
</div>