task icon Task

Create Notion Page

Requirements
Content to create (title, body text, or rough notes), destination (workspace, under a specific page, or in a database), optional properties for database entries
3

Determine the destination type:

  • Workspace page: Standalone page at workspace root
  • Child page: Under an existing page
  • Database entry: As a row in a database (requires matching properties)

If destination is unclear, check uiConnection Profiles for:

  • Active databases (if content matches a database structure)
  • Recent pages (if they mention a parent page)

If still unclear, ask: "Should this be a standalone page, or do you want to add it somewhere specific?"

4

For database entries:

  • Identify the target database from the profile's Quick Access section
  • Match properties to the database schema
  • Ask for any required properties not provided

For pages:

  • Structure content with appropriate blocks (headings, paragraphs, lists)
  • Use callouts for important notes
  • Add code blocks for any code content
5

Write a preview draft with _action frontmatter:


_action:
label: "Create page"
prompt: "Create this Notion page using the content below. Convert to Notion blocks."
isComplete: false

Destination: [workspace / parent page name / database name]
Title: [page title]
Properties: (for database entries)

Content

[page content in markdown]

Sauna displays this as a preview card with a "Create page" button.
User can edit the content, then click to create.

6

Create the page using the Notion API.

On success: Share the page URL and confirm what was created.
On error: Explain the issue (common: page not shared with integration, property mismatch).

                    To run this task you must have the following required information:

> Content to create (title, body text, or rough notes), destination (workspace, under a specific page, or in a database), optional properties for database entries

If you don't have all of this information, exit here and respond asking for any extra information you require, and instructions to run this task again with ALL required information.

---

You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Read External Actions Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/sauna.actions.external.md` (Preview UI pattern for external actions)

2. [Read Notion Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/content.notion.guide.md` (Notion API reference for page creation)

3. Determine the destination type:
- **Workspace page**: Standalone page at workspace root
- **Child page**: Under an existing page
- **Database entry**: As a row in a database (requires matching properties)

If destination is unclear, check `./documents/connections/[service-name].md` for:
- Active databases (if content matches a database structure)
- Recent pages (if they mention a parent page)

If still unclear, ask: "Should this be a standalone page, or do you want to add it somewhere specific?"


4. For database entries:
- Identify the target database from the profile's Quick Access section
- Match properties to the database schema
- Ask for any required properties not provided

For pages:
- Structure content with appropriate blocks (headings, paragraphs, lists)
- Use callouts for important notes
- Add code blocks for any code content


5. Write a preview draft with _action frontmatter:

---
_action:
  label: "Create page"
  prompt: "Create this Notion page using the content below. Convert to Notion blocks."
  isComplete: false
---

**Destination:** [workspace / parent page name / database name]
**Title:** [page title]
**Properties:** (for database entries)
- [property]: [value]

## Content

[page content in markdown]

Sauna displays this as a preview card with a "Create page" button.
User can edit the content, then click to create.


6. Create the page using the Notion API.

On success: Share the page URL and confirm what was created.
On error: Explain the issue (common: page not shared with integration, property mismatch).