> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# AddScheduleItem

# Package: eventManagement

# Namespace: ScheduleManagement

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/schedule-items/add-schedule-item.md

## Permission Scopes:
Manage Events - all permissions: SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS

## Introduction

Adds a schedule item to a draft schedule.  For the same date and time you can have multiple items.

Note that draft items are not publicly available unless published.

---

## REST API

### Schema

```
 Method: addScheduleItem
 Description: Adds a schedule item to a draft schedule.  For the same date and time you can have multiple items.  Note that draft items are not publicly available unless published.
 URL: https://www.wixapis.com/events/v1/schedule/draft
 Method: POST
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  eventId, item.name, item.timeSlot, item.timeSlot.start, item.timeSlot.end
 Method parameters: 
   param name: eventId | type: eventId | description: Event GUID to add the schedule item to. | required: true
   param name: item | type: ScheduleItemData | description: Schedule item describes the schedule within an event. Each event may contain multiple schedule items. 
        - name: hidden | type: boolean | description: Whether the schedule item is hidden from guests. 
        - name: name | type: string | description: Schedule item name. | required: true
        - name: timeSlot | type: TimeInterval | description: Time slot of a schedule item. | required: true
           - name: start | type: string | description: Start of the time slot interval, inclusive. | required: true
           - name: end | type: string | description: End of the time slot interval, exclusive. | required: true
           - name: timeZoneId | type: string | description: Time zone GUID in TZ database format, e.g., `"EST"`, `"America/Los_Angeles"`. Defaults to `"Etc/UTC"` when not set. 
        - name: description | type: string | description: Rich text schedule item description. 
        - name: stageName | type: string | description: Stage or room name in which a session takes place. 
        - name: tags | type: array | description: Schedule item tags. Used to organize the items by a theme. 
        - name: status | type: ScheduleStatus | description: Schedule item status. 
             - enum:
             -     SCHEDULED: Item is scheduled for a future date.
             -     CANCELED: Item is canceled.
 Return type: AddScheduleItemResponse
  - name: item | type: ScheduleItem | description: Schedule item. 
     - name: id | type: string | description: Schedule item GUID. 
     - name: hidden | type: boolean | description: Whether a schedule item is hidden from guests. 
     - name: name | type: string | description: Schedule item name. 
     - name: timeSlot | type: TimeInterval | description: Time slot of a schedule item. 
        - name: start | type: string | description: Start of the time slot interval, inclusive. 
        - name: end | type: string | description: End of the time slot interval, exclusive. 
        - name: timeZoneId | type: string | description: Time zone GUID in TZ database format, e.g., `"EST"`, `"America/Los_Angeles"`. Defaults to `"Etc/UTC"` when not set. 
     - name: description | type: string | description: Rich text schedule item description. 
     - name: stageName | type: string | description: Stage or room name in which a session takes place. 
     - name: tags | type: array | description: Schedule item tags. Used to organize the items by a theme. 
     - name: status | type: ScheduleStatus | description: Schedule item status. 
         - enum:
         -     SCHEDULED: Item is scheduled for a future date.
         -     CANCELED: Item is canceled.
     - name: createdDate | type: string | description: Date and time the schedule item was created. 
     - name: updatedDate | type: string | description: Date and time the schedule item was updated. 
     - name: eventId | type: string | description: Event GUID to which the schedule item belongs. 
     - name: draft | type: boolean | description: Whether the schedule item is a draft. 


```

### Examples

### AddScheduleItem
```curl
~~~cURL
curl -X POST 'https://www.wixapis.com/events/v1/agenda/draft' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH TOKEN>'
~~~
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.eventManagement.ScheduleManagement.addScheduleItem(eventId, options)
 Description: Adds a schedule item to a draft schedule.  For the same date and time you can have multiple items.  Note that draft items are not publicly available unless published.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  eventId, options.item.name, options.item.timeSlot, options.item.timeSlot.start, options.item.timeSlot.end
 Method parameters: 
   param name: eventId | type: string | description: Event GUID to add the schedule item to. | required: true
   param name: options | type: AddScheduleItemOptions  none 
        - name: item | type: ScheduleItemData | description: Schedule item. 
           - name: hidden | type: boolean | description: Whether the schedule item is hidden from guests. 
           - name: name | type: string | description: Schedule item name. | required: true
           - name: timeSlot | type: TimeInterval | description: Time slot of a schedule item. | required: true
              - name: start | type: Date | description: Start of the time slot interval, inclusive. | required: true
              - name: end | type: Date | description: End of the time slot interval, exclusive. | required: true
              - name: timeZoneId | type: string | description: Time zone GUID in TZ database format, e.g., `"EST"`, `"America/Los_Angeles"`. Defaults to `"Etc/UTC"` when not set. 
           - name: description | type: string | description: Rich text schedule item description. 
           - name: stageName | type: string | description: Stage or room name in which a session takes place. 
           - name: tags | type: array | description: Schedule item tags. Used to organize the items by a theme. 
           - name: status | type: ScheduleStatus | description: Schedule item status. 
                 - enum:
                 -     SCHEDULED: Item is scheduled for a future date.
                 -     CANCELED: Item is canceled.
 Return type: PROMISE<AddScheduleItemResponse>
  - name: item | type: ScheduleItem | description: Schedule item. 
     - name: _id | type: string | description: Schedule item GUID. 
     - name: hidden | type: boolean | description: Whether a schedule item is hidden from guests. 
     - name: name | type: string | description: Schedule item name. 
     - name: timeSlot | type: TimeInterval | description: Time slot of a schedule item. 
        - name: start | type: Date | description: Start of the time slot interval, inclusive. 
        - name: end | type: Date | description: End of the time slot interval, exclusive. 
        - name: timeZoneId | type: string | description: Time zone GUID in TZ database format, e.g., `"EST"`, `"America/Los_Angeles"`. Defaults to `"Etc/UTC"` when not set. 
     - name: description | type: string | description: Rich text schedule item description. 
     - name: stageName | type: string | description: Stage or room name in which a session takes place. 
     - name: tags | type: array | description: Schedule item tags. Used to organize the items by a theme. 
     - name: status | type: ScheduleStatus | description: Schedule item status. 
         - enum:
         -     SCHEDULED: Item is scheduled for a future date.
         -     CANCELED: Item is canceled.
     - name: _createdDate | type: Date | description: Date and time the schedule item was created. 
     - name: _updatedDate | type: Date | description: Date and time the schedule item was updated. 
     - name: eventId | type: string | description: Event GUID to which the schedule item belongs. 
     - name: draft | type: boolean | description: Whether the schedule item is a draft. 


```

### Examples

### addScheduleItem
```javascript
import { schedule } from '@wix/events';

async function addScheduleItem(eventId,options) {
  const response = await schedule.addScheduleItem(eventId,options);
};
```

### addScheduleItem (with elevated permissions)
```javascript
import { schedule } from '@wix/events';
import { auth } from '@wix/essentials';

async function myAddScheduleItemMethod(eventId,options) {
  const elevatedAddScheduleItem = auth.elevate(schedule.addScheduleItem);
  const response = await elevatedAddScheduleItem(eventId,options);
}
```

### addScheduleItem (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { schedule } from '@wix/events';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { schedule },
  // Include the auth strategy and host as relevant
});


async function addScheduleItem(eventId,options) {
  const response = await myWixClient.schedule.addScheduleItem(eventId,options);
};
```

---