Create Calendar Block

Required fields: startDate, endDate, startTime, endTime and reason.

Calendar blocks can be set to specific time ranges or for the whole day by setting startTime=0 and

Calendar blocks can be for a specific date range instance or set to repeat at a specified frequency.

Repeat object: (repeats = true)

The frequency can be set to a value of D, W or M for Day, Week or Month respectively.

Use the interval property to specify the interval that the block repeats. For example, an interval of 2
for a weekly block means that the block will repeat every 2nd week beginning at the day specified. A
daily block with an interval of 10 means the block will repeat every 10 days. The interval property
applies to all repeat frequencies. If using the repeat functionality an interval value is required.

Daily blocks: Will repeat for each day of the week for the date range specified for the interval
specified. An interval value of “1” repeats every day, and an interval value of “3” is every 3rd day.

Weekly blocks: Will repeat only on the specified days of the week for the date range specified.
For weekly the frequency is required and should be set to “W”. You must specify the
“weekdays” parameter. Weekdays are expressed as a string of digits with each single digit in the
string representing a day of the week. The possible values are 0,1,2,3,4,5,6 where 0=Sunday,1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday. For example, a weekly
frequency with an interval of “1”, and an entry of weekdays = “24”, will repeat each week on Tuesday
and Thursday for the duration of the block date range.

Monthly blocks: Will repeat either on the day of the month specified in the monthDay property
or on the day of the week and week of the month specified by the monthType property. In both
cases frequency is required and should be set to “M”, monthly.

monthDay is the day of the month you want blocked. If monthDay=’15’ this means to block the
15th of every month in the date range requested. Using monthDay in conjunction with monthType
addresses “day of the week and week of the month” scenario. There are two possible values
for monthType: D for Day of Month or W for Week of Month.

For monthType D, monthDay value must be between 1 and 31. It is the day of the month to repeat
on. For monthType M, monthDay value contains 2 digits: day of week (0-6), (0,1,2,3,4,5,6 where
0=Sunday, 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday) and week of month
(1-5). 1 being the first week, 2 being the second. The third Thursday of the month is depicted as a
monthType=”M” and monthDay=”43”.

Repeat will end on the date specified by the end date.
You can specify “9999-12-31” in the endDate field to indicate the repeating block should continue indefinitely.

Click Try It! to start a request and see the response here!