The request body should look like the following:

{
  "events": [
    EVENTS TO CREATE
  ]
}

Each event should have the following properties

Field	Type	Description
calendar	String (Required unless calendar_id specified)	The name of the calendar to add the event to. If the calendar doesn't exist then a new one will be provisioned.
calendar_id	Integer (Required unless calendar specified)	The id of the calendar
title	String (Required)	The title of the event
start_time	String (Required)	The start time of the event in ISO 8601 combined date and time format including timezone offset. e.g. 2016-06-21T14:00:00-08:00
end_time	String (Required)	The end time of the event in ISO 8601 combined date and time format. e.g. 2016-06-21T15:00:00-08:00
time_zone	String	The time zone the event is in. This will influence what time will be used in messages sent as long as the "Use time zone specified for event" option is enabled for the account (which it is by default). See this page for timezones supported.
location	String	The location of the event
content	String	The content / body of the vent
all_day	Boolean Default: false	Specifies that event should be treated as an all day event
show_as	Integer Default: null	null: "Busy" 0: "Free" 1: "Tentative" 2: "Busy" 3: "Out of Office" 4: "Working Elsewhere"
external_id	String	An optional unique identifier (should be unique across all calendars in user's account). Can be used to fetch updates and update events.
custom_data	JSON Hash	A hash of custom data to be attached to the event. Custom data can be used in Apptoto conditions and message templates.
participants	Array	Array of participants to be added. This is optional. Apptoto can extract participants from the title/location/content for you. But if you want to explicitly include participants you can include them in this Array.

Each Participant object should include the following properties

Field	Type	Description
name	String	The name of the participant
email	String	The SMTP email address of the participant
phone	String	The phone of the participant. This phone number will be normalized based on the user's country setting. Alternatively you can include the full normalized phone number (e.g. +441212121212) and Apptoto will then skip normalization.
contact_id	Integer	The id of a contact in Apptoto to directly link the event to. You should not include name/email/phone if you provide an explicit contact_id.
contact_externalId	String	The external_id of a contact you've created in Apptoto. The external_id can be specified when you create it in Apptoto through the API, or for some types of Address Books (like Salesforce, you can use the Salesforce contact id as the external_id)

Example Result:

{ 
  events: [ EVENTS CREATED ]
}