Skip to content

Create Events ​

Endpoint ​

http
POST /unified/calendar/events
Integrations supported
  • Google Calendar
  • Outlook Calendar

Query parameters ​

Refer Specifying query parameters in Truto APIs

integrated_account_id
string · uuid
REQUIRED · 

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_format
string

The format of the response.

  • unified will return the response with unified mappings applied.
  • raw will return the raw response from the remote API.
  • normalized will apply the unified mappings and return the data in a normalized format.

Defaults to unified.

All possible enum values:
  • unified
  • raw
  • normalized
Example: unified
truto_ignore_remote_data
boolean

Excludes the remote_data attribute from the response.

truto_exclude_fields
array

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_query
object

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar
send_notifications
string
All possible enum values:
  • all
  • external_only
  • none
Supported in
  • Google Calendar

Request Body ​

Refer Writing data using Unified APIs

calendar
object

The calendar associated with the event.

Required in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the calendar.

name
string

The name of the calendar.

start_time
string · date-time
REQUIRED · 

The date and time when the event starts.

Required in
  • Google Calendar
  • Outlook Calendar
end_time
string · date-time

The date and time when the event ends.

Required in
  • Google Calendar
  • Outlook Calendar
timezone
string

The timezone of the event.

Required in
  • Outlook Calendar
Supported in
  • Google Calendar
title
string
REQUIRED · 

The title of the event.

Required in
  • Outlook Calendar
Supported in
  • Google Calendar
description
string

The description of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
status
string

The status of the event.

All possible enum values:
  • confirmed
  • tentative
  • cancelled
  • draft
Supported in
  • Google Calendar
availability
string

The availability of the user during the time period of the event.

All possible enum values:
  • busy
  • free
Supported in
  • Google Calendar
visibility
string

The visibility of the event.

All possible enum values:
  • calendar_default
  • public
  • private
Supported in
  • Google Calendar
recurrence
string[]

The recurrence of the event. List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545.

Supported in
  • Google Calendar
attendees
object[]

The attendees associated with the event.

Supported in
  • Google Calendar
  • Outlook Calendar
person
object

The person associated with the attendee.

id
string

The unique identifier of the person.

name
string

The name of the person.

emails
object[]

The emails of the person.

email
string

The email of the person.

type
string

The type of the email.

is_optional
boolean

Indicates if the attendance is optional.

is_self
boolean

Indicates if the attendee is the authenticated user.

is_organizer
boolean

Indicates if the attendee is the organizer of the event.

response
object

The response of the attendee.

status
string

The status of the response.

All possible enum values:
  • needs_action
  • declined
  • tentative
  • accepted
comment
string

The comment of the response.

type
string

The type of the event.

All possible enum values:
  • default
  • out_of_office
  • focus_time
  • working_location
Supported in
  • Google Calendar
guests_can_invite_others
boolean

Indicates if guests can invite others to the event.

Supported in
  • Google Calendar
guests_can_modify
boolean

Indicates if guests can modify the event.

Supported in
  • Google Calendar
guests_can_see_other_guests
boolean

Indicates if guests can see other guests of the event.

Supported in
  • Google Calendar
location
object

The location of the event.

Supported in
  • Outlook Calendar
id
string

The unique identifier of the location.

name
string

The name of the location.

address
object
street_1
string

The first line of the street address.

street_2
string

The second line of the street address.

city
string

The city of the address.

state
string

The state of the address.

country
string

The country of the address.

postal_code
string

The postal code of the address.

url
string

The URL of the location.

coordinates
object
latitude
number

The latitude of the location.

longitude
number

The longitude of the location.

remote_data
object

Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

Response Body ​

id
string
REQUIRED · 

The unique identifier of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
calendar
object

The calendar associated with the event.

Supported in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the calendar.

name
string

The name of the calendar.

title
string
REQUIRED · 

The title of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
description
string

The description of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
location
object

The location of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the location.

name
string

The name of the location.

address
object
street_1
string

The first line of the street address.

street_2
string

The second line of the street address.

city
string

The city of the address.

state
string

The state of the address.

country
string

The country of the address.

postal_code
string

The postal code of the address.

url
string

The URL of the location.

coordinates
object
latitude
number

The latitude of the location.

longitude
number

The longitude of the location.

timezone
string

The timezone of the event.

Supported in
  • Google Calendar
  • Outlook Calendar
start_time
string · date-time
REQUIRED · 

The date and time when the event starts.

Supported in
  • Google Calendar
  • Outlook Calendar
end_time
string · date-time

The date and time when the event ends.

Supported in
  • Google Calendar
  • Outlook Calendar
status
string

The status of the event.

All possible enum values:
  • confirmed
  • tentative
  • cancelled
  • draft
Supported in
  • Google Calendar
  • Outlook Calendar
attendees
object[]

The attendees associated with the event.

Supported in
  • Google Calendar
  • Outlook Calendar
person
object

The person associated with the attendee.

id
string

The unique identifier of the person.

name
string

The name of the person.

emails
object[]

The emails of the person.

email
string

The email of the person.

type
string

The type of the email.

is_optional
boolean

Indicates if the attendance is optional.

is_self
boolean

Indicates if the attendee is the authenticated user.

is_organizer
boolean

Indicates if the attendee is the organizer of the event.

response
object

The response of the attendee.

status
string

The status of the response.

All possible enum values:
  • needs_action
  • declined
  • tentative
  • accepted
comment
string

The comment of the response.

created_by
object

The person who created the event.

Supported in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the person.

name
string

The name of the person.

emails
object[]

The emails of the person.

email
string

The email of the person.

type
string

The type of the email.

organized_by
object

The person who created the event.

Supported in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the person.

name
string

The name of the person.

emails
object[]

The emails of the person.

email
string

The email of the person.

type
string

The type of the email.

type
string

The type of the event.

All possible enum values:
  • default
  • out_of_office
  • focus_time
  • working_location
Supported in
  • Google Calendar
  • Outlook Calendar
availability
string

The availability of the user during the time period of the event.

All possible enum values:
  • busy
  • free
Supported in
  • Google Calendar
  • Outlook Calendar
visibility
string

The visibility of the event.

All possible enum values:
  • calendar_default
  • public
  • private
Supported in
  • Google Calendar
  • Outlook Calendar
identifiers
object

The identifiers associated with the event.

Supported in
  • Google Calendar
  • Outlook Calendar
ical_uid
string

The iCalendar UID of the event.

ical_sequence
string

The iCalendar sequence of the event.

is_locked
boolean

Indicates if the event is locked and cannot be modified.

Supported in
  • Google Calendar
urls
object

The URLs associated with the event.

Supported in
  • Google Calendar
  • Outlook Calendar
url
string

The URL of the event.

type
string

The type of the URL.

is_recurring
boolean

Indicates if the event is recurring.

Supported in
  • Google Calendar
  • Outlook Calendar
recurrence
string[]

The recurrence of the event. List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545.

Supported in
  • Google Calendar
  • Outlook Calendar
parent_event
object

The parent event of a recurring event.

Supported in
  • Google Calendar
  • Outlook Calendar
id
string

The unique identifier of the parent event.

has_attachments
boolean

Indicates if the event has attachments.

Supported in
  • Google Calendar
  • Outlook Calendar
attachments
object[]

The attachments associated with the event.

Supported in
  • Google Calendar
id
string

The unique identifier of the attachment.

name
string

The name of the attachment.

mime_type
string

The MIME type of the attachment.

url
string

The URL of the attachment.

created_at
string · date-time

The date when the attachment was created.

updated_at
string · date-time

The date when the attachment was updated.

guests_can_invite_others
boolean

Indicates if guests can invite others to the event.

Supported in
  • Google Calendar
guests_can_modify
boolean

Indicates if guests can modify the event.

Supported in
  • Google Calendar
guests_can_see_other_guests
boolean

Indicates if guests can see other guests of the event.

Supported in
  • Google Calendar
event_type
object

The event type object associated with the event.

id
string

The unique identifier of the event type.

created_at
string · date-time

The date when the event was created.

Supported in
  • Google Calendar
  • Outlook Calendar
updated_at
string · date-time

The date when the event was updated.

Supported in
  • Google Calendar
  • Outlook Calendar
remote_data
object

Raw data returned from the remote API call.