Jump to a Section

Overview

Authorizing an Office 365 Calendar Account

The first time you use an Office 365 Calendar card in your FLO, you will need to authorize an account.

  1. Add an Account Nickname. This should be unique, so that in the case that your teammates authorize multiple accounts, you will be able to tell them apart.
  2. Click “Create” to launch a window where you will sign in to your account and the save this configuration.

    Events

    • Monitor New Events

      This FLO runs when a new calendar event is created.

      Note that the date and time fields are in the text type, not the date type - that’s because this connector was developed before the date type was available for connectors.  If you need to convert them to the date type, try the Text to Date function.

      Output Fields

      • EventId (text):  the event id of the newly created event
      • OrganizerName (text):  the name of the person who created the event
      • OrganizerEmail (text):  the email address of the person who created the event
      • StartTime (text): the time the event starts
      • EndTime (text): the time the event ends
      • Subject (text): the subject of the event
      • Html (text): the event description, in HTML format (i.e. text plus HTML markup)
      • CreatedDateTime (text): the date and time that the event was created
      • Attendees Email (list of text): a list of all attendee email addresses
      • location (text): The location of the event
      • BodyPreview (text): The preview of the message associated with the event
      • Importance (text): The importance of the event; this will be either Low, Normal, or High
      • Sensitivity (text): Indicates the level of privacy for the event: Normal = 0, Personal = 1, Private = 2, Confidential = 3
      • IsAllDay (True/False): Set to true if the event lasts all day
      • IsCancelled (True/False): Set to true if the event has been canceled
      • isOrganizer (True/False): Set to true if the message sender is also the organizer
      • ResponseRequested (True/False): Set to true if the sender would like a response when the event is accepted or declined
      • SeriesMasterid (text): The categories assigned to the item
      • ShowAs (text): The status to show: Free = 0, Tentative = 1, Busy = 2, Oof = 3, WorkingElsewhere = 4, Unknown = -1
      • type (text): The event type: SingleInstance = 0, Occurrence = 1, Exception = 2, SeriesMaster = 3
      • WebLink (text): The URL to open the event in Outlook Web App. This URL can be accessed from within an iFrame
      • OnlineMeetingUrl (text): A URL for an online meeting
      • HasAttachments (True/False): Set to true if the event has attachments
      • OriginalStartTimeZone (text): The start time zone that was set when the event was created. See here for more details.
      • OriginalEndTimeZone (text): The end time zone that was set when the event was created. See here for more details.
      • Execution ID (text): The unique identifier for the execution of the FLO.

      External Documentation

      https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/api/version-2.0/complex-types-for-mail-contacts-calendar#EventResource

    • Monitor Updated Event

      This FLO runs when a calendar event is updated.

      Note that the date and time fields are in the text type, not the date type - that’s because this connector was developed before the date type was available for connectors.  If you need to convert them to the date type, try the Text to Date function.

      Output Fields

      • EventId (text):  the event id of the newly created event
      • OrganizerName (text):  the name of the person who created the event
      • OrganizerEmail (text):  the email address of the person who created the event
      • StartTime (text): the time the event starts
      • EndTime (text): the time the event ends
      • Subject (text): the subject of the event
      • Html (text): the event description, in HTML format (i.e. text plus HTML markup)
      • CreatedDateTime (text): the date and time that the event was created
      • LastModifiedDateTime (text): the date and time that the event was last modified
      • Attendees Email (list of text): a list of all attendee email addresses
      • location (text): The location of the event
      • BodyPreview (text): The preview of the message associated with the event
      • Importance (text): The importance of the event; this will be either Low, Normal, or High
      • Sensitivity (text): Indicates the level of privacy for the event: Normal = 0, Personal = 1, Private = 2, Confidential = 3
      • IsAllDay (True/False): Set to true if the event lasts all day
      • IsCancelled (True/False): Set to true if the event has been canceled
      • isOrganizer (True/False): Set to true if the message sender is also the organizer
      • ResponseRequested (True/False): Set to true if the sender would like a response when the event is accepted or declined
      • SeriesMasterid (text): The categories assigned to the item
      • ShowAs (text): The status to show: Free = 0, Tentative = 1, Busy = 2, Oof = 3, WorkingElsewhere = 4, Unknown = -1
      • type (text): The event type: SingleInstance = 0, Occurrence = 1, Exception = 2, SeriesMaster = 3
      • WebLink (text): The URL to open the event in Outlook Web App. This URL can be accessed from within an iFrame
      • OnlineMeetingUrl (text): A URL for an online meeting
      • HasAttachments (True/False): Set to true if the event has attachments
      • OriginalStartTimeZone (text): The start time zone that was set when the event was created. See here for more details.
      • OriginalEndTimeZone (text): The end time zone that was set when the event was created. See here for more details.
      • Execution ID (text): The unique identifier for the execution of the FLO.

      External Documentation

      https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/api/version-2.0/complex-types-for-mail-contacts-calendar#EventResource

    Actions

    • Create Event

      This card creates an event in a Microsoft Office365 Calendar.

      Input Fields

      First input the information about the event to create it. 

      • To (text):
        • Fill in the email of the person invited to the event.
      • ToName (Name):
        • Fill in the name to which the event is addressed to.
      • StartTime (Text):
        • Fill in the time in which the event starts in HH: MM format.
      • EndTime (Text):
        • Fill in the time in which the event ends in HH: MM format.
      • Subject (Text):  
        • Choose a header for the event topic.
      • HTML (Text):
        • Fill in a longer description of the event.

      Output Fields

      • Event ID (text):
        • This card outputs an event ID. In other cards, it is possible to locate this event with this ID.
    • Delete Event

      This card deletes an existing event in Office 365 Calendar.

      Input Fields

      • Event ID

        • The ID of the event that you want to delete. One way to do this is by dragging the ID from the create event card.

    • Read Event

      This card returns information about an existing event.

      Input 

      • Search
        • EventId (Number): The ID of the event that you want to read. This can be dragged from the create event card.

      Output

      • Event:
        • EventId (Number): the same EventID entered in the Eventid input field.
        • OrganizerName (text): the name of the organizer.
        • OrganizerEmail (text): the email address of the organizer.
        •  StartTime (Time): the starting time of the event.
        • EndTime (Time): the end time of the event.
        • Subject (text): the subject of the event.
        • HTML (text): the description of the event.
    • Update Event

      Update Event

      Update an existing calendar event.

      Input Fields

      • Update By
        • Event ID (text): ID of the event to be updated
      • Event
        • To (text): email address of event attendee
        • ToName (text): name of event attendee
        • StartTime (text): the time the event starts
        • EndTime (text): the time the event ends
        • Subject (text): the subject of the event
        • Html (text): custom HTML to be included in the event description