List Tasks
GET
/unified/crm/tasks
Query Parameters
Refer Specifying query parameters in Truto APIs
ownerobject
The task's owner
11 supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
idstring
required·
The task's owner
created_atstring · date-time
The date and time of the task's creation
5 supported
supported
supported
supported
supported
supported
updated_atstring · date-time
The date and time of the task's last update
4 supported
supported
supported
supported
supported
due_datestring · date-time
The date and time of the task's due date
3 supported
supported
supported
supported
completed_atstring · date-time
The date and time of the task's completion
2 supported
supported
supported
statusstring
The task's status
Possible values:
blockedclosedcompletecompleteddeferredincompletenot_startedopenpending
9 supported
supported
opencompletedpendingsupported
openclosedsupported
opencompletedsupported
opencompletedKeapsupported
opencompletedsupported
completeincompletependingsupported
opencloseddeferrednot_startedblockedsupported
supported
accountobject
The task's account
References: Accounts → id
7 supported
supported
supported
supported
supported
supported
supported
supported
idstring
required·
The account's unique identifier
sort_by
Possible values:
completed_atcreated_atdue_datestatussubjectupdated_at
8 supported
supported
created_atupdated_atsupported
created_atupdated_atsupported
created_atupdated_atdue_datesupported
created_atupdated_atstatuscompleted_atsubjectsupported
subjectcreated_atupdated_atsupported
due_datesupported
due_datecreated_atupdated_atcompleted_atsupported
created_atupdated_atworkspaceobject[]
1 supported1 required
required
idstring
required
contactobject
The task's contact
References: Contacts → id
8 supported1 required
required
supported
supported
Keapsupported
supported
supported
supported
supported
idstring
required·
The contact's unique identifier
idstring
required·
The contact's unique identifier
namestring
The contact's name
search_term
3 supported
supported
supported
supported
subjectstring
The task's subject
4 supported
supported
supported
supported
supported
contentstring
The task's content
3 supported
supported
supported
supported
opportunityobject[]
The task's opportunity
References: Opportunities → id
2 supported
supported
supported
idstring
required·
The opportunity's unique identifier
leadobject[]
The task's lead
References: Leads → id
2 supported
supported
supported
idstring
required·
The lead's unique identifier
Show Truto-specific parameters
integrated_account_idstring · uuid
required·
The ID of the integrated account to use for the request.
Example:
62f44730-dd91-461e-bd6a-aedd9e0ad79dtruto_response_formatstring
The format of the response.
unifiedreturns the response with unified mappings applied.rawreturns the unprocessed, raw response from the remote API.normalizedapplies the unified mappings and returns the data in a normalized format.streamreturns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.debugreturns the final unified result alongside raw remote fetch information. The response is an envelope containingresult(identical to unified mode output) anddebug(withrequestUrl,requestOptions,data,responseHeaders, and for list operations:nextCursor,isLooping,isEmptyResult,resultCount).debugisnullfor static responses or whentruto_skip_api_call=true.
Defaults to unified.
Example:
unified
Possible values:
unifiedrawnormalizedstreamdebug
truto_key_bystring
By default the result attribute is an array of objects. This parameter allows you to specify a field in each result objects to use as key, which transforms the result array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
Example:
idtruto_ignore_limitboolean
Ignores the limit query parameter.
truto_ignore_remote_databoolean
Excludes the remote_data attribute from the response.
truto_exclude_fieldsstring[]
Array of fields to exclude from the response.
Example:
truto_exclude_fields[]=id&truto_exclude_fields[]=nameremote_queryRecord<string, any>
Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
Example:
remote_query[foo]=barResponse Body
debugobject
Present only when truto_response_format=debug. Contains raw fetch details: requestUrl, requestOptions, data, responseHeaders, nextCursor, isLooping, isEmptyResult, resultCount. null for static responses or when truto_skip_api_call=true.
data
isEmptyResultboolean
isLoopingboolean
nextCursorstring
requestOptionsRecord<string, any>
requestUrlstring
responseHeadersRecord<string, any>
resultCountnumber
next_cursorstring
The cursor to use for the next page of results. Pass this value as next_cursor in the query parameter in the next request to get the next page of results.
resultobject[]
List of Tasks
idstring
required·
The task's unique identifier
20 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
accountobject
The task's account
References: Accounts → id
14 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
1 property
idstring
The account's unique identifier
completed_atstring · date-time
The date and time of the task's completion
14 supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
contactobject[]
The task's contact
References: Contacts → id
16 supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
2 properties
idstring
The contact's unique identifier
namestring
The contact's name
contentstring
The task's content
18 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
created_atstring · date-time
The date and time of the task's creation
19 supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
due_datestring · date-time
The date and time of the task's due date
18 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
etagstring
The unique identifier for the specific version of the resource.
1 supported
supported
leadobject[]
The task's lead
References: Leads → id
4 supported
supported
supported
supported
supported
2 properties
idstring
The lead's unique identifier
namestring
The lead's name
opportunityobject[]
The task's opportunity
References: Opportunities → id
9 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
2 properties
idstring
The opportunity's unique identifier
namestring
The opportunity's name
ownerobject
The task's owner
20 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
2 properties
idstring
The owner's unique identifier
namestring
The owner's name
remote_dataRecord<string, any>
Raw data returned from the remote API call.
statusstring
The task's status
Possible values:
opencompleted
20 supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
subjectstring
The task's subject
17 supported
supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
typeobject
The task's type
11 supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
2 properties
idstring
The type's unique identifier
namestring
The type's name
updated_atstring · date-time
The date and time of the task's last update
18 supported
supported
supported
supported
supported
supported
supported
supported
Keapsupported
supported
supported
supported
supported
supported
supported
supported
supported
supported
supported
urlsobject[]
The task's urls
6 supported
supported
supported
supported
supported
supported
supported
2 properties
typestring
The task's URL type
urlstring
The task's URL
curl -X GET 'https://api.truto.one/unified/crm/tasks?integrated_account_id=<integrated_account_id>' \
-H 'Authorization: Bearer <your_api_token>' \
-H 'Content-Type: application/json'const integratedAccountId = '<integrated_account_id>';
const response = await fetch(`https://api.truto.one/unified/crm/tasks?integrated_account_id=${integratedAccountId}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer <your_api_token>',
'Content-Type': 'application/json',
},
});
const data = await response.json();
console.log(data);import requests
url = "https://api.truto.one/unified/crm/tasks"
headers = {
"Authorization": "Bearer <your_api_token>",
"Content-Type": "application/json",
}
params = {
"integrated_account_id": "<integrated_account_id>"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())import Truto from '@truto/truto-ts-sdk';
const truto = new Truto({
token: '<your_api_token>',
});
const result = await truto.unifiedApi.list(
'crm',
'tasks',
{ integrated_account_id: '<integrated_account_id>' }
);
console.log(result);import asyncio
from truto_python_sdk import TrutoApi
truto_api = TrutoApi(token="<your_api_token>")
async def main():
async for item in truto_api.unified_api.list(
"crm",
"tasks",
{"integrated_account_id": "<integrated_account_id>"}
):
print(item)
asyncio.run(main())