Skip to main content
Kinetic Community

SharePoint Event Create

This handler creates a new event within a SharePoint Calendar.


By downloading this file, you acknowledge that you agree to our Terms of Service

The SharePoint handlers require Kinetic Task 2.0 and version 0.8.8 or above of the JOpenSSL library. To fulfill these requirements, either make sure all of your handlers that require OpenSSL are all on version 0.8.8 or above OR configure the handlers to execute in a distributed task engine that is only responsible for SharePoint handlers. For more information on configuring distributed task engines, see Configuring Distributed Task Engines.

Note: This handler requires that Microsoft SharePoint must be setup to support Basic Authentication and SSL to correctly authenticate the calls the handler makes. A step-by-step process to setting this up can be found here.

Detailed Description

This handler makes a SOAP call (using Savon) to the SharePoint Web Services to create a new event in a SharePoint calendar. After 
configuring Savon to work with the given account credentials, a few inputted values are checked for validity while the time parameters are
configured so that SharePoint will recognize them. Next, the Batch XML structure is built to give the Web Service the information it needs to create the new event, which is then passed via a SOAP call to SharePoint, where the event is created on the specified calendar. Any errors that occur during this process will be caught and re-raised by the handler. Authentication is done through SSL, so the SharePoint site being accessed needs to be setup to allow SSL connections.
Note: Make sure the SharePoint Web Services database is turned on.

How to Obtain the Homepage URL Info Value

To find the homepage url, all you have to do is look at the URL of any page on the SharePoint site. The url that should be inputted should contain both the base url (the top-most site in the collection) and the sub-site that you are on. For example, given the following URL:

The base site is "", the sub-site is "development" and the 'HomePage URL' task info values should be set to:


Name Description
Title The title of the new event.
Location The location of the new event.
Start Date The start date of the new event in YYYY-MM-DD format.
Start Time The start time of the new event in HH:MM format. Both 12 hr (01:00 PM) and 24 hr (13:00) formatting are allowed. If it is an All-Day event, leave this blank.
End Date The end date of the new event in YYYY-MM-DD format.
End Time The end time of the new event in HH:MM format. Both 12 hr (01:00 PM) and 24 hr (13:00) formatting are allowed. If it is an All-Day event, leave this blank.
Description A description of the new task.
Category The category that this event will be filed under.
Calendar The name of the calendar you wish to add this event to. The default calendar is 'Calendar'.

Sample Configuration

Parameter Example Configuration
Title Sample Title
Location City Hall
Start Date 2012-08-03
Start Time 03:00 PM
End Date 2012-08-04
End Time 05:00 PM
Description This is a sample event
Category Work
Calendar Calendar


This handler does not return any results

Change Log

Version Date Description
1 2012-08-03 Initial Version
2 2013-10-08 JOpenSSL updated to version 0.8.8 and self signed cert info value removed