> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create task

> Create a new task in your CRM

<Card title="Your Implementation Required" icon="triangle-exclamation" color="#f59e0b">
  This endpoint must be implemented on **your server**
</Card>

Enginy calls this endpoint to create tasks from campaign sequences.

## Request

<ParamField body="subject" type="string" required>
  Task subject/title
</ParamField>

<ParamField body="description" type="string">
  Task description
</ParamField>

<ParamField body="type" type="string">
  Task type (e.g., "call", "email", "follow-up")
</ParamField>

<ParamField body="ownerId" type="string">
  User ID to assign the task to
</ParamField>

<ParamField body="dueDate" type="string">
  Due date in ISO 8601 format
</ParamField>

<ParamField body="contactId" type="string">
  Associated contact's CRM ID
</ParamField>

<ParamField body="companyId" type="string">
  Associated company's CRM ID
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "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"
  }
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string" required>
  The created task's CRM ID
</ResponseField>

<ResponseField name="subject" type="string">
  Task subject
</ResponseField>

<ResponseField name="completed" type="boolean">
  Completion status (initially false)
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "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"
  }
  ```
</ResponseExample>