Tasks

The Task object is used to represent a task, such as a to-do item.

The Task object

Properties


subjectString
Optional
The task's subject.

contentString
Optional
The task's content.

ownerString
Optional
The task's owner.

accountString
Optional
The task's account.

completed_dateString
Optional
When the task is completed.

due_dateString
Optional
When the task is due.

statusEnum
Optional
The task's status. Possible values include: OPEN, CLOSED, or - in cases where there is no clear mapping - the original value passed through.

remote_dataRemoteData[]
Optional

remote_was_deletedBoolean
Required
Indicates whether or not this object has been deleted by third party webhooks.

idString
Required

remote_idString
Optional
The third-party API ID of the matching object.

field_mappingsObject
Optional

remote_fieldsRemoteField[]
Required

The Task object
JSON
{
"subject": "Contact about Integration Strategy",
"content": "Follow up to see whether they need integrations",
"owner": "0358cbc6-2040-430a-848e-aafacbadf3aa",
"account": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"completed_date": "2022-02-11T00:00:00Z",
"due_date": "2022-02-10T00:00:00Z",
"status": "OPEN",
"remote_data": [
{
"path": "/tasks",
"data": [
"Varies by platform"
]
}
],
"remote_was_deleted": true,
"id": "03455bc6-6040-430a-848e-aafacbfdf4fg",
"remote_id": "19202938",
"field_mappings": {
"organization_defined_targets": {
"custom_key": "custom_value"
},
"linked_account_defined_targets": {
"custom_key": "custom_value"
}
},
"remote_fields": [
{
"value": {}
}
]
}

GET

/tasks

Returns a list of Task objects.


Header Parameters


AuthorizationString
Required
Token-based authentication with required prefix "Bearer"

X-Account-TokenString
Required
Token identifying the end user.

Query & Path Parameters


created_afterString
Optional
If provided, will only return objects created after this datetime.

created_beforeString
Optional
If provided, will only return objects created before this datetime.

cursorString
Optional
The pagination cursor value.

expandString
Optional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

include_deleted_dataBoolean
Optional
Whether to include data that was marked as deleted by third party webhooks.

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsBoolean
Optional
Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.

modified_afterString
Optional
If provided, will only return objects modified after this datetime.

modified_beforeString
Optional
If provided, will only return objects modified before this datetime.

page_sizeInteger
Optional
Number of results to return per page.

remote_idString
Optional
The API provider's ID for the given object.

Response
JSON
{
"next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
"previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
"results": [
{
"subject": "Contact about Integration Strategy",
"content": "Follow up to see whether they need integrations",
"owner": "0358cbc6-2040-430a-848e-aafacbadf3aa",
"account": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"completed_date": "2022-02-11T00:00:00Z",
"due_date": "2022-02-10T00:00:00Z",
"status": "OPEN",
"remote_data": [
{
"path": "/tasks",
"data": [
"Varies by platform"
]
}
],
"remote_was_deleted": true,
"id": "03455bc6-6040-430a-848e-aafacbfdf4fg",
"remote_id": "19202938",
"field_mappings": {
"organization_defined_targets": {
"custom_key": "custom_value"
},
"linked_account_defined_targets": {
"custom_key": "custom_value"
}
},
"remote_fields": [
{
"value": {}
}
]
}
]
}
Field support by platform

Accelo

Accelo

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Capsule

Capsule

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Close

Close

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Copper

Copper

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

HubSpot

HubSpot

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Insightly

Insightly

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Keap

Keap

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Microsoft Dynamics 365 Sales

Microsoft Dynamics 365 Sales

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Nutshell

Nutshell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Pipedrive

Pipedrive

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

subjectString

Salesflare

Salesflare

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Salesforce

Salesforce

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

SugarCRM

SugarCRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamleader

Teamleader

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamwork CRM

Teamwork CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Zendesk Sell

Zendesk Sell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_idString

statusEnum

Zoho CRM

Zoho CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString
Hint: Use the /linked-accounts endpoint to pull platform support information.
GET

/tasks/{id}

Returns a Task object with the given id.


Header Parameters


AuthorizationString
Required
Token-based authentication with required prefix "Bearer"

X-Account-TokenString
Required
Token identifying the end user.

Query & Path Parameters


expandString
Optional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

idString
Required

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsBoolean
Optional
Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.

Response
JSON
{
"subject": "Contact about Integration Strategy",
"content": "Follow up to see whether they need integrations",
"owner": "0358cbc6-2040-430a-848e-aafacbadf3aa",
"account": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"completed_date": "2022-02-11T00:00:00Z",
"due_date": "2022-02-10T00:00:00Z",
"status": "OPEN",
"remote_data": [
{
"path": "/tasks",
"data": [
"Varies by platform"
]
}
],
"remote_was_deleted": true,
"id": "03455bc6-6040-430a-848e-aafacbfdf4fg",
"remote_id": "19202938",
"field_mappings": {
"organization_defined_targets": {
"custom_key": "custom_value"
},
"linked_account_defined_targets": {
"custom_key": "custom_value"
}
},
"remote_fields": [
{
"value": {}
}
]
}
Field support by platform

Accelo

Accelo

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Capsule

Capsule

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Close

Close

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Copper

Copper

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

HubSpot

HubSpot

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Insightly

Insightly

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Keap

Keap

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Microsoft Dynamics 365 Sales

Microsoft Dynamics 365 Sales

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Nutshell

Nutshell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Pipedrive

Pipedrive

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

subjectString

Salesflare

Salesflare

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Salesforce

Salesforce

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

SugarCRM

SugarCRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamleader

Teamleader

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamwork CRM

Teamwork CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Zendesk Sell

Zendesk Sell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_idString

statusEnum

Zoho CRM

Zoho CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString
Hint: Use the /linked-accounts endpoint to pull platform support information.
GET

/tasks/remote-field-classes

CLOSED BETA

Returns a list of RemoteFieldClass objects.


Header Parameters


AuthorizationString
Required
Token-based authentication with required prefix "Bearer"

X-Account-TokenString
Required
Token identifying the end user.

Query & Path Parameters


cursorString
Optional
The pagination cursor value.

include_deleted_dataBoolean
Optional
Whether to include data that was marked as deleted by third party webhooks.

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsBoolean
Optional
Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.

page_sizeInteger
Optional
Number of results to return per page.

Response
JSON
{
"next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
"previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
"results": [
{
"display_name": "string",
"remote_key_name": "string",
"description": "string",
"is_required": true,
"field_choices": [
"string"
],
"item_schema": {
"item_type": "string",
"item_format": "string",
"item_choices": [
"string"
]
},
"is_custom": true,
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
}
Field support by platform

Accelo

Accelo

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Capsule

Capsule

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Close

Close

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Copper

Copper

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

HubSpot

HubSpot

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Insightly

Insightly

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Keap

Keap

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Microsoft Dynamics 365 Sales

Microsoft Dynamics 365 Sales

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Nutshell

Nutshell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Pipedrive

Pipedrive

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

subjectString

Salesflare

Salesflare

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Salesforce

Salesforce

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

SugarCRM

SugarCRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamleader

Teamleader

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Teamwork CRM

Teamwork CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString

Zendesk Sell

Zendesk Sell

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

completed_dateString

contentString

due_dateString

ownerString

remote_idString

statusEnum

Zoho CRM

Zoho CRM

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


completed_dateString

contentString

due_dateString

ownerString

remote_dataRemoteData[]
pathstring
dataobject

remote_idString

statusEnum

subjectString
Hint: Use the /linked-accounts endpoint to pull platform support information.