Skip to main content
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
Enginy calls this endpoint to create tasks from campaign sequences.

​
Request

​
subject
string
required
Task subject/title
​
description
string
Task description
​
type
string
Task type (e.g., “call”, “email”, “follow-up”)
​
ownerId
string
User ID to assign the task to
​
dueDate
string
Due date in ISO 8601 format
​
contactId
string
Associated contact’s CRM ID
​
companyId
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

​
id
string
required
The created task’s CRM ID
​
subject
string
Task subject
​
completed
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"
}