Skip to content

Docs / All tools / Loop III: Assistant

outlook_calendar.create_event

Create an Outlook Calendar event.

5 credits. Per event created. 0 when cancelled.

Example prompt

Send this to your AI app when Heelo is connected:

Schedule lunch with [email protected] tomorrow at noon

Input fields

FieldTypeDescription
querystringNatural-language event request.
titlestringExplicit event title.
startstringExplicit RFC3339/local start; bypasses NL time parsing.
endstringExplicit RFC3339/local end.
timezonestringIANA timezone override.
attendeesarray of stringAttendee emails.
locationstringEvent location.
descriptionstringEvent body/notes.
all_daybooleanWhether this is an all-day event.
session_idstringMulti-turn session id.
messagestringFollow-up answer in a multi-turn session.
review_idstringAn approved review (doc.review_decide) that this write uses; it is claimed before the write.

Output fields

The fields in data when status is success.

FieldTypeDescription
createdboolean
eventobject
timezone_notestringSet when the event's zone is a fallback: tell the user.

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/outlook_calendar.create_event/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "Schedule lunch with [email protected] tomorrow at noon",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())