Create task

{
  "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"
}

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

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"
}

Overview Get task

Getting Started

Contacts

Companies

Associations

Tasks

Activities

Users (Optional)

Examples

Your Implementation Required

Request

Response

Your Implementation Required

​Request

​Response

Request

Response