List tasks
Your Freshsales tasks, filtered by status and by the deal or contact they belong to.
GET https://cotlet.dev/api/v1/freshsales/tasks
read
Returns tasks with title, due date, status, owner and the deal, contact or account each is related to. Freshsales shows a task only to its owner and its collaborators, so you see your own tasks and the ones shared with you, not the whole team. Read a page at a time with next_cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| filter string required | string | open, overdue or completed. |
| deal_id integer | integer | Only tasks related to this deal. |
| contact_id integer | integer | Only tasks related to this contact. |
| cursor string | string | next_cursor of the previous page. |
Request
curl "https://cotlet.dev/api/v1/freshsales/tasks?filter=filter" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("freshsales", "list_tasks", {"filter":"filter"})const result = await cotlet.call('freshsales', 'list_tasks', {"filter":"filter"});cotlet call freshsales list_tasks --data '{"filter":"filter"}'Example response
{
"tasks": [
{
"task_id": 8800121,
"title": "Send revised quote",
"due": "2026-10-19T10:00:00",
"status": "open",
"overdue": true,
"owner": "Dana Reyes",
"related_to": {
"type": "Deal",
"id": 7000412,
"name": "Website redesign"
}
}
],
"next_cursor": null
}