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 answers404with "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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
leadId | Query | integer | No | Only tasks on this lead. A member needs access to the lead |
status | Query | string | No | pending or completed. Applies only without leadId |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
leadId | Body | integer | Yes | The lead the task is on. A member needs access to it |
title | Body | string | Yes | The task title |
description | Body | string | No | More detail |
dueDate | Body | string | No | YYYY-MM-DD or an ISO 8601 timestamp with an offset |
assigneeIds | Body | string or string[] | No | Owners other than the key's person |
teamIds | Body | UUID or UUID[] | No | Put the task on every member of these teams |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
taskId | Path | string | Yes | The id of the task |
title | Body | string | No | New title |
description | Body | string | No | New description |
dueDate | Body | string | No | YYYY-MM-DD or an ISO 8601 timestamp with an offset |
status | Body | string | No | pending or completed |
assigneeIds | Body | string or string[] | No | Admins only |
teamIds | Body | UUID or UUID[] | No | Admins only |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
taskId | Path | string | Yes | The id of the task |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
from | Query | string | Yes | First day, YYYY-MM-DD, in tz |
to | Query | string | Yes | The day after the last day (exclusive), YYYY-MM-DD. At most 42 days after from |
tz | Query | string | Yes | IANA time zone, 1 to 64 characters, such as Europe/Madrid |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
from | Query | string | Yes | First day, YYYY-MM-DD, in tz |
to | Query | string | Yes | The day after the last day (exclusive). At most 14 days after from |
tz | Query | string | Yes | IANA time zone. Required |
durationMinutes | Query | integer | Yes | 15 to 480 |
leadId | Query | integer | No | A lead you can reach. Its own busy times are left out too |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
eventId | Path | string | Yes | The eventId of a calendar item; a viewing with no event yet is viewing:<id> |
title | Body | string | No | New title |
startsAt | Body | string | No | New start, ISO 8601 with an offset |
endsAt | Body | string | No | New end, ISO 8601 with an offset |
timezone | Body | string | No | The IANA time zone the change was made in |
location | Body | string or null | No | New place or link, or null to clear it |
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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
eventId | Path | string | Yes | The eventId of a calendar item |
The response has the same shape as a move, with status cancelled. Errors as for a move.