Diese Seite wurde noch nicht in Ihre Sprache übersetzt. Angezeigt wird die Version Englisch (Vereinigtes Königreich).

Tasks and calendar

List, create, update and delete tasks, read a calendar window, find free times and move or cancel meetings through the Fondaro API.

Tasks hang on leads. The calendar shows the key's person what is on their day. Reading needs crm:read; creating, changing and deleting tasks, and moving or cancelling meetings, need crm:write and an active plan.

  • Tasks. A member creates and reads tasks on leads they can reach. Ticking or unticking a task is limited to its owner, a teammate on it, or an admin. Reassigning (assigneeIds) is admin-only. A lead or task you cannot reach answers 404 with "Lead not found." or "Task not found.".
  • Calendar. Always the key's person's own calendar, member or admin. Only the person whose calendar it is can move or cancel a meeting or viewing, and anyone invited is told from their own calendar.

Set a task's due date

A task's dueDate takes either form:

  • YYYY-MM-DD: due that day with no time. It is stored and returned as midnight UTC on that date.
  • A full ISO 8601 timestamp with an offset, such as 2026-10-12T09:30:00+02:00: that exact moment.

The calendar routes take plain YYYY-MM-DD dates and a required tz, an IANA time zone such as Europe/Madrid. The dates are days in that zone, and to is exclusive. A request without tz answers 400.

List tasks

GET /v1/tasks

Without leadId, at most 500 tasks the key's person owns or is on. There is no agency-wide task list, even for admins. With leadId, that lead's tasks. hasMore is true only when the 500-row limit cut the results.

ParameterInTypeRequiredDescription
leadIdQueryintegerNoOnly tasks on this lead. A member needs access to the lead
statusQuerystringNopending or completed. Applies only without leadId
bash
curl "https://api.fondaro.com/v1/tasks?leadId=1042" \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "data": [    {      "id": "3f6c2a10-0000-4000-8000-000000000008",      "leadId": 1042,      "assigneeIds": ["user_2abcDEF1234567890ghiJKL"],      "createdBy": "user_2abcDEF1234567890ghiJKL",      "title": "Viewing follow-up",      "description": null,      "dueDate": "2026-10-12T00:00:00.000Z",      "status": "pending",      "completedAt": null,      "createdAt": "2026-10-04T12:02:13.420Z",      "updatedAt": "2026-10-04T12:02:13.420Z"    }  ],  "hasMore": false}

Create a task

POST /v1/tasks

Creates a task on a lead. The owner defaults to the key's person. Accepts an Idempotency-Key header.

ParameterInTypeRequiredDescription
leadIdBodyintegerYesThe lead the task is on. A member needs access to it
titleBodystringYesThe task title
descriptionBodystringNoMore detail
dueDateBodystringNoYYYY-MM-DD or an ISO 8601 timestamp with an offset
assigneeIdsBodystring or string[]NoOwners other than the key's person
teamIdsBodyUUID or UUID[]NoPut the task on every member of these teams
bash
curl -X POST https://api.fondaro.com/v1/tasks \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "leadId": 1042, "title": "Viewing follow-up", "dueDate": "2026-10-12" }'

The 201 response is the task, as in the list above. Errors: 404 "Lead not found." for a lead you cannot reach.

Update a task

PATCH /v1/tasks/{taskId}

Changes the title, description, due date or status. Send status: "completed" to tick it and "pending" to untick it. Reassigning with assigneeIds or teamIds is admin-only.

ParameterInTypeRequiredDescription
taskIdPathstringYesThe id of the task
titleBodystringNoNew title
descriptionBodystringNoNew description
dueDateBodystringNoYYYY-MM-DD or an ISO 8601 timestamp with an offset
statusBodystringNopending or completed
assigneeIdsBodystring or string[]NoAdmins only
teamIdsBodyUUID or UUID[]NoAdmins only
bash
curl -X PATCH https://api.fondaro.com/v1/tasks/3f6c2a10-0000-4000-8000-000000000008 \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "status": "completed" }'

The response is the task with "status": "completed" and a completedAt time. Errors: 403 when you may not tick it or may not reassign; 404 "Task not found."

Delete a task

DELETE /v1/tasks/{taskId}

Permanently deletes a task. Only its owner, a teammate on it, or an admin can.

ParameterInTypeRequiredDescription
taskIdPathstringYesThe id of the task
bash
curl -X DELETE https://api.fondaro.com/v1/tasks/3f6c2a10-0000-4000-8000-000000000008 \  -H "Authorization: Bearer $FONDARO_API_KEY"

The response is 204 with no body.

Read the calendar

GET /v1/calendar

The key's person's calendar for a window of days: meetings, viewings, tasks, open houses, expected deal closes and connected appointments. The window is at most 42 days. If more items exist than one response holds, truncated is true: ask for a shorter window.

ParameterInTypeRequiredDescription
fromQuerystringYesFirst day, YYYY-MM-DD, in tz
toQuerystringYesThe day after the last day (exclusive), YYYY-MM-DD. At most 42 days after from
tzQuerystringYesIANA time zone, 1 to 64 characters, such as Europe/Madrid
bash
curl "https://api.fondaro.com/v1/calendar?from=2026-10-05&to=2026-10-12&tz=Europe%2FMadrid" \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "window": { "from": "2026-10-05", "to": "2026-10-12", "tz": "Europe/Madrid" },  "truncated": false,  "items": [    {      "kind": "meeting",      "title": "Weekly sales meeting",      "startsAt": "2026-10-05T07:00:00.000Z",      "endsAt": "2026-10-05T07:45:00.000Z",      "allDay": false,      "status": "confirmed",      "leadId": null,      "eventId": "3f6c2a10-0000-4000-8000-000000000020",      "attendeeCount": 0,      "done": false,      "overdue": false    }  ]}

Items carry startsAt and endsAt in UTC. Errors: 400 for a missing tz, an unknown time zone, or a window over 42 days.

Find free times

GET /v1/calendar/free-times

When the key's person is free for a meeting or viewing of a given length, inside their working hours, on the half hour, earliest first. The window is at most 14 days. Pass leadId to also leave out times when that lead already has something.

ParameterInTypeRequiredDescription
fromQuerystringYesFirst day, YYYY-MM-DD, in tz
toQuerystringYesThe day after the last day (exclusive). At most 14 days after from
tzQuerystringYesIANA time zone. Required
durationMinutesQueryintegerYes15 to 480
leadIdQueryintegerNoA lead you can reach. Its own busy times are left out too
bash
curl "https://api.fondaro.com/v1/calendar/free-times?from=2026-10-05&to=2026-10-06&tz=Europe%2FMadrid&durationMinutes=30" \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "timeZone": "Europe/Madrid",  "durationMinutes": 30,  "slots": [    { "startsAt": "2026-10-05T06:00:00.000Z", "endsAt": "2026-10-05T06:30:00.000Z" },    { "startsAt": "2026-10-05T06:30:00.000Z", "endsAt": "2026-10-05T07:00:00.000Z" }  ]}

Errors: 400 for a missing tz or a window over 14 days; 404 "Lead not found." when leadId is not yours.

Move or edit a meeting or viewing

PATCH /v1/calendar/events/{eventId}

Changes the start, end, title or place of a meeting or viewing on the key's person's own calendar. The length stays the same unless you send endsAt. Anyone invited is told about the change from the person's own connected calendar. Send at least one of title, startsAt, endsAt or location.

ParameterInTypeRequiredDescription
eventIdPathstringYesThe eventId of a calendar item; a viewing with no event yet is viewing:<id>
titleBodystringNoNew title
startsAtBodystringNoNew start, ISO 8601 with an offset
endsAtBodystringNoNew end, ISO 8601 with an offset
timezoneBodystringNoThe IANA time zone the change was made in
locationBodystring or nullNoNew place or link, or null to clear it
bash
curl -X PATCH https://api.fondaro.com/v1/calendar/events/3f6c2a10-0000-4000-8000-000000000020 \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{"startsAt": "2026-10-05T10:30:00+02:00", "timezone": "Europe/Madrid"}'
json
{  "eventId": "3f6c2a10-0000-4000-8000-000000000020",  "title": "Weekly sales meeting",  "startsAt": "2026-10-05T08:30:00.000Z",  "endsAt": "2026-10-05T09:15:00.000Z",  "status": "confirmed",  "leadId": null}

Errors: 400 for a task (change it as a task), an open house (change it from the open house) or an event already cancelled; 403 for an event on someone else's calendar.

Cancel a meeting or viewing

POST /v1/calendar/events/{eventId}/cancel

Cancels a meeting or viewing on the key's person's own calendar. It stays on record as cancelled, and anyone invited is told from the person's own connected calendar.

ParameterInTypeRequiredDescription
eventIdPathstringYesThe eventId of a calendar item
bash
curl -X POST https://api.fondaro.com/v1/calendar/events/3f6c2a10-0000-4000-8000-000000000020/cancel \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'

The response has the same shape as a move, with status cancelled. Errors as for a move.