> ## 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 List item

> Create an item, duplicate, or subtask in a Slack List.

`slack.createListItem` creates a record in a List on a paid Slack workspace.

```ts automations/create-release-item.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { slack } from "automate.ax/slack"

export default automation("Create release item", () => {
  onDashboardRun({ title: "Create release item" })

  slack.createListItem({
    listId: "F012ABCD3EF",
    fields: [
      { columnId: "ColName", type: "richText", value: [] },
      { columnId: "ColStatus", type: "select", value: ["OptReady"] },
    ],
  })
})
```

## Inputs

| Input              | Type                   | Required | Description                          |
| ------------------ | ---------------------- | -------- | ------------------------------------ |
| `listId`           | `string`               | Yes      | List receiving the item.             |
| `fields`           | `SlackListItemField[]` | No       | Initial typed cell values.           |
| `duplicatedItemId` | `string`               | No       | Existing item to copy.               |
| `parentItemId`     | `string`               | No       | Parent item when creating a subtask. |

Each field has `columnId`, a `type`, and a matching `value`. Supported types are `attachment`, `channel`, `checkbox`, `date`, `email`, `link`, `message`, `number`, `phone`, `rating`, `reference`, `richText`, `select`, `timestamp`, and `user`. Dates use `YYYY-MM-DD`; message values are Slack message URLs; references accept Slack file IDs.

## Output

Returns the created item with `id`, `listId`, `createdAt`, typed `fields`, and available creator, update, archive, parent, and subscription metadata.