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