outlook_ calendar. list_ events
List Outlook Calendar events within a date range.
2 credits. Per call.
Example prompt
Send this to your AI app when Heelo is connected:
What meetings do I have tomorrow?
Input fields
| Field | Type | Description |
|---|---|---|
query | string | Natural-language time range, e.g. 'what meetings do I have tomorrow?' |
timezone | string | IANA timezone (e.g. America/New_York). Overrides the default. |
start | string | Explicit RFC3339 start; bypasses natural-language parsing. |
end | string | Explicit RFC3339 end; bypasses natural-language parsing. |
max_results | integer | Maximum number of events to return. |
Output fields
The fields in data when status is success.
| Field | Type | Description |
|---|---|---|
range | object | |
count | integer | |
events | array of object | |
interpretation | string | |
timezone_note | string | Set when the range'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.list_events/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"query": "What meetings do I have tomorrow?",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/outlook_calendar.list_events/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"query": "What meetings do I have tomorrow?"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());