> ## 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 Notion page

> Create a page with properties and optional initial content.

`notion.createPage` create a page with properties and optional initial content.

## Example

```ts automations/notion-create-page.automation.ts theme={null}
import { automation, onSchedule } from "automate.ax"
import { notion } from "automate.ax/notion"

export default automation("Create Notion page", () => {
  onSchedule({ schedule: "0 9 * * *" })

  notion.createPage({
    parent: { type: "page_id", page_id: "parent-page-id" },
    properties: {},
  })
})
```

## Inputs

`parent` and `properties` are optional for connection types that may create a private workspace page. Markdown cannot be combined with `content` or `children`, and templates cannot be combined with `children`. Set `allow_async` with markdown when Notion should create the page as a background task. Every input accepts a compatible signal, and an optional second argument can select a named account.

## Output

Returns the created full or partial `page` object for a synchronous request. An asynchronous markdown request returns an `async_task`; pass its `id` to `getAsyncTask` and respect `poll_after_seconds` while it is pending.