Tasks, newest activity first by default. Scope: crm.
Query parameters
| Parameter | Required | Example | Description |
|---|---|---|---|
status |
No | todo |
`todo`, `in_progress` or `done`. |
assignee_user_id |
No | 3 |
Assignee (team member) id. |
contact_id |
No | 42 |
Contact id. |
deal_id |
No | 15 |
Deal id. |
due_before |
No | 2026-10-15T00:00:00Z |
Due before this time (ISO 8601). |
due_after |
No | 2026-10-01T00:00:00Z |
Due after this time (ISO 8601). |
q |
No | call |
Free text. |
sort |
No | due_at |
Sort key. |
dir |
No | asc |
`asc` or `desc`. |
updated_since |
No | 2026-10-01T00:00:00Z |
Only tasks updated at or after this time. |
created_since |
No | 2026-10-01T00:00:00Z |
Only tasks created at or after this time. |
page |
No | 1 |
Page number. |
per_page |
No | 25 |
Rows per page, up to 100. |
Example request
curl -G "https://your-workspace.letsbot.net/api/v1/crm/tasks" \
-H "X-Zapier-Api-Key: YOUR_WORKSPACE_API_KEY" \
-H "Accept: application/json"const response = await fetch("https://your-workspace.letsbot.net/api/v1/crm/tasks", {
method: "GET",
headers: {
"X-Zapier-Api-Key": "YOUR_WORKSPACE_API_KEY",
"Accept": "application/json",
},
});
const data = await response.json();
console.log(data);<?php
$ch = curl_init('https://your-workspace.letsbot.net/api/v1/crm/tasks');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-Zapier-Api-Key: YOUR_WORKSPACE_API_KEY',
'Accept: application/json',
],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);import requests
response = requests.request(
"GET",
"https://your-workspace.letsbot.net/api/v1/crm/tasks",
headers={
"X-Zapier-Api-Key": "YOUR_WORKSPACE_API_KEY",
"Accept": "application/json",
},
)
print(response.json())Responses
One page200
{
"success": true,
"data": [
{
"id": 31,
"title": "Call back about the quote",
"description": "Confirm delivery date.",
"status": "todo",
"priority": "high",
"due_at": "2026-10-10T11:00:00+03:00",
"remind_at": "2026-10-10T10:30:00+03:00",
"overdue": false,
"assignee": {
"id": 3,
"name": "Sara Ahmed"
},
"contact": {
"id": 42,
"name": "Ahmed Ali",
"phone": "966500000000"
},
"deal": {
"id": 15,
"title": "Epoxy kit order — 40 units"
},
"recurrence": null,
"completed_at": null,
"created_at": "2026-10-08T09:30:00+03:00",
"updated_at": "2026-10-08T09:30:00+03:00",
"url": "https://your-workspace.letsbot.net/panel/v2/tasks?task=31"
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 25,
"total": 1
}
}