API reference
Google Calendar and Outlook Calendar
The first-day invites (and optional task due dates) Bizisy puts on the connected calendar for new hires: what is planned, what is on the calendar and when the rest goes out. The template is a connection setting; connecting happens in the web app.
1 action · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
Planned calendar invites for new hires#
POST/v1/org/calendar.agendaRead
What Bizisy puts on the connected calendar (Google Calendar or Outlook Calendar) for hires starting in the next 60 days: each first-day meeting of the company's template (Integrations → the calendar → Agenda) with its day, time, time zone and invited people, and, when task due dates are on, onboarding tasks as all-day events. state: on_calendar, next_sync or scheduled (sends_on: invites go out at most send_days_before days before the first day). person_id narrows to one hire. connected: whether the calendar is connected (planned events are listed either way, as the template would plan them). Invited people are names only, never email addresses. The template is changed with integrations_connections_update (settings: first_day, send_days_before, meetings, task_due; owners and admins, in Bizisy); Sync now is integrations_connections_run. Owners, admins and HR; never custom roles.
- Who can call it
- Manage key owner admin hr
- MCP tool
org_calendar_agendaon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
connector"google_calendar" | "outlook_calendar"requiredperson_idstring1–64 characters.
Returns
connector"google_calendar" | "outlook_calendar"requiredconnectedbooleanrequiredstatusstring | nullrequiredsettingsobjectrequiredThe template in use: the connection's settings, or the defaults until connected.
5 fields
first_daybooleanrequiredsend_days_beforeintegerrequiredFrom 1 to 60.
meetingsobject[]requiredUp to 6 items.
10 fields
idstringrequiredPattern
^[a-z0-9]{1,12}$.titlestringrequired1–80 characters.
dayintegerrequiredFrom 0 to 20.
timestringrequiredPattern
^([01]\d|2[0-3]):[0-5]\d$.minutesintegerrequiredFrom 5 to 480.
new_hirebooleanrequiredmanagerbooleanrequiredteambooleanrequiredperson_idsstring[]required1–64 characters. Up to 10 items.
notestring | nullrequiredUp to 500 characters.
task_duebooleanrequiredinterviewsbooleanrequired
eventsobject[]required12 fields
idstringrequiredStable id of the planned event (first:<person>:<meeting> or task:<checklist>:<task>).
kind"meeting" | "task" | "away"requiredmeeting or task (this agenda lists only these); away: an out-of-office day from time off.
personobjectrequiredThe new hire.
4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
titlestringrequireddaystringrequiredYYYY-MM-DD, local to the hire's location.
all_daybooleanrequiredstartstringrequiredendstringrequiredTimed: ISO instants. All day: the day and the next (end exclusive).
time_zonestringrequiredattendeesobject[]requiredInvited people (the organizer, the connected account, is not listed).
4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
state"on_calendar" | "next_sync" | "scheduled"requiredon_calendar: sent and up to date; next_sync: goes out or is updated at the next run (within the hour, or Sync now); scheduled: goes out on sends_on.
sends_onstringrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/calendar.agenda \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"connector":"outlook_calendar","person_id":"p1"}'const res = await fetch('https://api.bizisy.com/v1/org/calendar.agenda', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"connector": "outlook_calendar",
"person_id": "p1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/org/calendar.agenda",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"connector": "outlook_calendar",
"person_id": "p1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"connector": "outlook_calendar",
"connected": true,
"status": "connected",
"settings": {
"first_day": true,
"send_days_before": 14,
"task_due": false,
"interviews": true,
"meetings": [
{
"id": "welcome",
"title": "Welcome meeting",
"day": 0,
"time": "09:30",
"minutes": 30,
"new_hire": true,
"manager": true,
"team": false,
"person_ids": [],
"note": null
}
]
},
"events": [
{
"id": "first:p1:welcome",
"kind": "meeting",
"person": {
"id": "p1",
"name": "Noa Silva",
"title": "Engineer",
"photo_url": null
},
"title": "Welcome meeting: Noa Silva",
"day": "2026-10-12",
"all_day": false,
"start": "2026-10-12T08:30:00.000Z",
"end": "2026-10-12T09:00:00.000Z",
"time_zone": "Europe/Lisbon",
"attendees": [
{
"id": "p1",
"name": "Noa Silva",
"title": "Engineer",
"photo_url": null
},
{
"id": "p2",
"name": "Mia Rocha",
"title": "Lead",
"photo_url": null
}
],
"state": "on_calendar",
"sends_on": "2026-09-28"
},
{
"id": "task:r1:t5",
"kind": "task",
"person": {
"id": "p1",
"name": "Noa Silva",
"title": "Engineer",
"photo_url": null
},
"title": "Plan the first week: Noa Silva",
"day": "2026-10-10",
"all_day": true,
"start": "2026-10-10",
"end": "2026-10-11",
"time_zone": "Europe/Lisbon",
"attendees": [],
"state": "scheduled",
"sends_on": "2026-09-26"
}
]
}
}Something missing or wrong on this page? Write to hello@bizisy.com.