{
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"ownerId": "user-123",
"dueDate": "2024-12-31T10:00:00Z",
"contactId": "contact_8f3k2j",
"companyId": "account_4k8j2m"
}
{
"id": "task-abc123",
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"dueDate": "2024-12-31T10:00:00Z",
"completed": false,
"createdAt": "2024-12-15T10:00:00Z"
}
Tasks
Create task
Create a new task in your CRM
POST
/
tasks
{
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"ownerId": "user-123",
"dueDate": "2024-12-31T10:00:00Z",
"contactId": "contact_8f3k2j",
"companyId": "account_4k8j2m"
}
{
"id": "task-abc123",
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"dueDate": "2024-12-31T10:00:00Z",
"completed": false,
"createdAt": "2024-12-15T10:00:00Z"
}
Your Implementation Required
This endpoint must be implemented on your server
Request
string
required
Task subject/title
string
Task description
string
Task type (e.g., “call”, “email”, “follow-up”)
string
User ID to assign the task to
string
Due date in ISO 8601 format
string
Associated contact’s CRM ID
string
Associated company’s CRM ID
{
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"ownerId": "user-123",
"dueDate": "2024-12-31T10:00:00Z",
"contactId": "contact_8f3k2j",
"companyId": "account_4k8j2m"
}
Response
string
required
The created task’s CRM ID
string
Task subject
boolean
Completion status (initially false)
{
"id": "task-abc123",
"subject": "Follow up call",
"description": "Discuss partnership proposal",
"type": "call",
"dueDate": "2024-12-31T10:00:00Z",
"completed": false,
"createdAt": "2024-12-15T10:00:00Z"
}