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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create contact task

> Creates a task attached to one contact.

`highlevel.createContactTask` creates a task attached to one contact.

```ts automations/highlevel-create-contact-task.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Create contact task", () => {
  markSignificant(
    highlevel.createContactTask({
      contactId: "sx6wyHhbFdRXh302LLNR",
      title: "First Task",
      dueDate: "2020-10-25T11:00:00Z",
      completed: true,
    }),
  )
})
```

## Input

| Field        | Type      | Required | Description                  |
| ------------ | --------- | -------- | ---------------------------- |
| `contactId`  | `string`  | Yes      | HighLevel contact id value.  |
| `title`      | `string`  | Yes      | HighLevel title value.       |
| `body`       | `string`  | No       | HighLevel body value.        |
| `dueDate`    | `string`  | Yes      | HighLevel due date value.    |
| `completed`  | `boolean` | Yes      | HighLevel completed value.   |
| `assignedTo` | `string`  | No       | HighLevel assigned to value. |

Automate.ax supplies the connected sub-account's location ID. Optional second argument `{ account }` selects a named HighLevel binding.

## Output

| Field  | Type     | Required | Description           |
| ------ | -------- | -------- | --------------------- |
| `task` | `object` | No       | HighLevel task value. |

This action calls `POST /contacts/{contactId}/tasks` with HighLevel API version `2021-07-28` and requires `contacts.write`. HighLevel validation and permission errors fail the action. Rate limits honor the provider's retry timing. Automate.ax does not automatically replay this create or send operation after an indeterminate transport failure.