> ## 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 board

> Create a Trello board, optionally from another board.

`createBoard` creates a private board by default. Place it in a Workspace, change visibility, or copy an existing board when starting from a template.

```ts automations/create-trello-board.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { createBoard } from "automate.ax/trello"

export default automation("Create launch board", () => {
  onHttpRequest({ scope: "automation" })
  createBoard({
    name: "Product launch",
    permissionLevel: "org",
    defaultLists: false,
  })
})
```

## Inputs

\| Property          | Type                     | Required  | Default         | Description                                            |
\| ----------------- | ------------------------ | --------- | --------------- | ------------------------------------------------------ | --------------------------------------- | ----------------- |
\| `name`            | `string`                 | Yes       | —               | Non-empty board name.                                  |
\| `description`     | `string`                 | No        | —               | Board description.                                     |
\| `organizationId`  | `string`                 | No        | —               | Owning Workspace ID.                                   |
\| `permissionLevel` | `"org"                   | "private" | "public"`       | No                                                     | `"private"`                             | Board visibility. |
\| `defaultLists`    | `boolean`                | No        | `true`          | Let Trello create its default lists.                   |
\| `selfJoin`        | `boolean`                | No        | —               | Allow Workspace members to join without an invitation. |
\| `sourceBoard`     | `string`                 | No        | —               | Board ID, short link, or URL to copy.                  |
\| `keepFromSource`  | `"cards"                 | "none"`   | No              | Provider default                                       | Content retained from the source board. |
\| `account`         | Trello account reference | No        | Project default | Account creating the board.                            |

## Output

Returns the created `TrelloBoard`. The connected member must be allowed to create boards with the requested Workspace and visibility settings.