Skip to main content

​
Overview

The Outlook Calendar tools allow you to automate various tasks related to Outlook Calendar, such as creating events, finding events, updating events, and deleting events using Microsoft Graph API.

​
Key Features

  • OUTLOOK_CALENDAR_FIND_EVENT
    • Find events in Outlook Calendar within a given time range or by search query.
  • OUTLOOK_CALENDAR_CREATE_EVENT
    • Create a new event in a specified calendar.
  • OUTLOOK_CALENDAR_UPDATE_EVENT
    • Update an existing event with new details.
  • OUTLOOK_CALENDAR_DELETE_EVENT
    • Delete an event from Outlook Calendar.

​
Authentication

To use the Outlook Calendar API, you need to navigate to the Jinba secrets dashboard and authenticate with your Microsoft account. This will create a new OAuth token for you. Note: Treat API keys as sensitive information and never commit them to public repositories. For further details, click here.

​
Example: Create, Update, Find, and Delete Events

- id: find_before
  tool: OUTLOOK_CALENDAR_FIND_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: timezone
      value: "+09:00"
    - name: time_min
      value: 2025-01-01T00:00:00Z
    - name: time_max
      value: 2025-01-31T23:59:59Z
    - name: query
      value: Test Event

- id: create_event
  tool: OUTLOOK_CALENDAR_CREATE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: summary
      value: Test Event
    - name: description
      value: This is a test event
    - name: timezone
      value: "+09:00"
    - name: start
      value: 2025-01-15T14:00:00
    - name: end
      value: 2025-01-15T15:00:00
    - name: attendees
      value: ""
    - name: content_type
      value: HTML

- id: update_event
  tool: OUTLOOK_CALENDAR_UPDATE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: event_id
      value: "{{steps.create_event.result.event.id}}"
    - name: summary
      value: Test Event (Updated)
    - name: description
      value: This event has been updated
    - name: timezone
      value: "+09:00"
    - name: start
      value: 2025-01-15T15:00:00
    - name: end
      value: 2025-01-15T16:00:00
    - name: content_type
      value: HTML

- id: find_after_update
  tool: OUTLOOK_CALENDAR_FIND_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: timezone
      value: "+09:00"
    - name: time_min
      value: 2025-01-01T00:00:00Z
    - name: time_max
      value: 2025-01-31T23:59:59Z
    - name: query
      value: "Test Event (Updated)"

- id: delete_event
  tool: OUTLOOK_CALENDAR_DELETE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: event_id
      value: "{{steps.create_event.result.event.id}}"

​
Tool Details

​
OUTLOOK_CALENDAR_FIND_EVENT

Searches for events in Outlook Calendar within a specified date range or by search query. Input Parameters:
  • calendar_id - Calendar ID (default: “default”)
  • query - Search query (partial match on event subject)
  • timezone - Timezone for naive datetimes (required, e.g., “Z”, “UTC”, “+09:00”)
  • time_min - Start time in RFC3339 format
  • time_max - End time in RFC3339 format
  • top - Maximum number of events to return (1-50, default: 10)
Output:
  • events - Array of matching events with id, subject, start, end, organizer, location, and webLink

​
OUTLOOK_CALENDAR_CREATE_EVENT

Creates a new event in Outlook Calendar. Input Parameters:
  • calendar_id - Calendar ID (default: “default”)
  • summary - Event title (required)
  • description - Event description (optional)
  • timezone - Timezone for naive datetimes (required, e.g., “Z”, “UTC”, “+09:00”)
  • start - Event start time in RFC3339 format (required)
  • end - Event end time in RFC3339 format (required)
  • attendees - Comma-separated email addresses (optional)
  • content_type - Description content type: “HTML” or “Text” (default: “HTML”)
Output:
  • event - Created event with id and webLink

​
OUTLOOK_CALENDAR_UPDATE_EVENT

Updates an existing event in Outlook Calendar. Input Parameters:
  • event_id - Event ID to update (required)
  • summary - New event title (optional)
  • description - New event description (optional)
  • timezone - Timezone for naive datetimes (required, e.g., “Z”, “UTC”, “+09:00”)
  • start - New event start time in RFC3339 format (optional, requires end)
  • end - New event end time in RFC3339 format (optional, requires start)
  • attendees - New attendee list (optional, replaces existing)
  • content_type - Description content type: “HTML” or “Text”
Output:
  • event - Updated event with id and webLink

​
OUTLOOK_CALENDAR_DELETE_EVENT

Deletes an event from Outlook Calendar. Input Parameters:
  • event_id - Event ID to delete (required)
Output:
  • status - HTTP status code of the deletion request