> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCalendarEventInput

> A new calendar event.

<ResponseField name="agenda" type={<a href="/docs/api-reference/v3/reference/commerce-agent/calendar-agenda-item-input">[CalendarAgendaItemInput!]</a>}>
  Agenda items to attach, in order. Each sets exactly one kind key. At most 20.

  <Expandable title="fields" lazyRender>
    <ResponseField name="promotion" type={<a href="/docs/api-reference/v3/reference/commerce-agent/calendar-promotion-agenda-item-input">CalendarPromotionAgendaItemInput</a>}>
      A PROMOTION item.

      <Expandable title="fields" lazyRender>
        <ResponseField name="details" type="String">
          What is discounted, for whom, and any code shoppers should use, written the way the Commerce Agent should read it; the agent may repeat it to shoppers. Required when adding a promotion. At most 2000 characters.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="allDay" type="Boolean">
  Whether the event spans whole days in `timezone`. Defaults to false.
</ResponseField>

<ResponseField name="description" type="String">
  Notes about the event, at most 1000 characters. The Commerce Agent reads them for MARKETING events and may repeat them to shoppers, so keep internal notes out.
</ResponseField>

<ResponseField name="endAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
  When the event ends. Must not be before `startAt`.
</ResponseField>

<ResponseField name="startAt" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime!</a>} required>
  When the event starts.
</ResponseField>

<ResponseField name="timezone" type="String!" required>
  The IANA time zone the event is written in, such as `America/New_York`.
</ResponseField>

<ResponseField name="title" type="String!" required>
  The name of the event, 1 to 200 characters. The Commerce Agent reads it for MARKETING events and may repeat it to shoppers.
</ResponseField>

<ResponseField name="type" type={<a href="/docs/api-reference/v3/reference/commerce-agent/calendar-event-type">CalendarEventType</a>}>
  The part of the business the event belongs to. Defaults to MARKETING.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.