The due date of a task is the timestamp field in the engagement body. Here's an example POST body for a task due on March 8th:
{
"engagement": {
"active": true,
"ownerId": 1,
"type": "TASK",
"timestamp": ((due date)) /* Here's the timestamp of the task's due date */
},
"associations": {
"contactIds": [12345],
"companyIds": [ ],
"dealIds": [ ],
"ownerIds": [ ]
},
"metadata": {
"body": "This is the body of the task.",
"subject": "This is the subject like of the task",
"status": "NOT_STARTED",
"forObjectType": "CONTACT"
}
}
You can create a reminder by including the "reminders" property in the metadata for the engagement. This example would create a reminger at March 2nd, 2017 11:45:00 AM EST: