POST

Create Schedule

Deprecation Warning

This method will be deprecated on June 30, 2025.
Replace with Create Schedule.

Creates a schedule.

Permissions This endpoint requires the Manage Bookings permissions scope

Endpoint
POST
https://www.wixapis.com/bookings/v1/calendar/schedules
Body Params
scheduleScheduleRequired

Schedule.

Response Object
scheduleSchedule

Schedule.

errorsArray <Error>deprecated

Create a schedule with recurring intervals.

Request
cURL
curl -X POST \
   'https://www.wixapis.com/bookings/v1/calendar/schedules' \
   -H "Content-Type: application/json" \
   -H 'Authorization: <AUTH>' \
   --data '{
             "schedule": {
               "scheduleOwnerId": "3d7dba43-d214-4149-8a53-a1a4a0c1e636",
               "intervals": [
                 {
                   "start": "2020-04-28T21:00:00Z",
                   "end": "2021-04-29T21:00:00.000Z",
                   "interval": {
                     "daysOfWeek": "THU",
                     "hourOfDay": 10,
                     "minuteOfHour": 0,
                     "duration": 180
                   },
                   "frequency": {
                     "repetition": 1
                   },
                   "affectedSchedules": [
                     {
                       "scheduleId": "e07c6328-4495-4b80-b04d-c45f13215881",
                       "transparency": "BUSY"
                     }
                   ]
                 }
               ],
               "title": "Intermediate Ski Class",
               "tags": [
                 "GROUP"
               ],
               "location": {
                 "locationType": "OWNER_BUSINESS"
               },
               "capacity": 50,
               "rate": {
                 "labeledPriceOptions": {
                   "general": {
                     "amount": "180",
                     "currency": "USD",
                     "downPayAmount": "0"
                   }
                 }
               }
             }
           }'
Response
JSON
{
  "schedule": {
    "id": "ef17e614-f318-41f4-9fc4-e6baa562f7e7",
    "scheduleOwnerId": "3d7dba43-d214-4149-8a53-a1a4a0c1e636",
    "firstSessionStart": "2020-04-30T14:00:00Z",
    "lastSessionEnd": "2021-04-29T17:00:00Z",
    "timeZone": "America/Denver",
    "intervals": [
      {
        "id": "4b8d0a0e-6e4e-4557-8377-f1209f759eb3",
        "start": "2020-04-28T21:00:00Z",
        "end": "2021-04-29T21:00:00.000Z",
        "interval": {
          "daysOfWeek": "THU",
          "hourOfDay": 10,
          "minuteOfHour": 0,
          "duration": 180
        },
        "frequency": {
          "repetition": 1
        },
        "affectedSchedules": [
          {
            "scheduleId": "e07c6328-4495-4b80-b04d-c45f13215881",
            "transparency": "BUSY",
            "scheduleOwnerId": "76570209-101f-409b-af97-b445bdb63125"
          }
        ]
      }
    ],
    "title": "Intermediate Ski Class",
    "tags": [
      "GROUP"
    ],
    "location": {
      "locationType": "OWNER_BUSINESS"
    },
    "capacity": 50,
    "rate": {
      "labeledPriceOptions": {
        "general": {
          "amount": "180",
          "currency": "USD",
          "downPayAmount": "0"
        }
      }
    },
    "totalNumberOfParticipants": 0,
    "participants": [
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Schedule Notification
Did this help?