Skip to main content

Notion Integration

Connect HealUp with Notion to pull tasks from your Notion databases and execute them with HealUp's AI breakdown and Execute Mode. Status updates sync back automatically.

Quick Start​

  1. Sign in to HealUp (authentication required)
  2. Settings → Integrations → Notion
  3. Click "Connect"
  4. Authorize HealUp in Notion popup
  5. Select databases to sync
  6. Start executing Notion tasks in HealUp

Total setup time: 3 minutes

Database-Powered Sync​

Notion → HealUp:
- Pull pages from connected databases
- Map to HealUp tasks
- Respect status properties

HealUp → Notion:
- Push task completions
- Update status in database
- Archive on delete

Sync Frequency​

Automatic:

  • Every 5 seconds while HealUp is open
  • Batch up to 50 tasks per sync
  • Background sync when active

Manual:

  • Click sync button anytime
  • Refresh from Settings

Step 1: Prepare Notion Database​

Requirements:

  • Notion database with:
    • Title property (required)
    • Status property (recommended)
    • Optional: Description, Due Date, Priority

Example Database:

Tasks Database
├── Title (title)
├── Status (status)
├── Description (text)
├── Due Date (date)
└── Priority (select)

Step 2: Connect Account​

  1. Open HealUp Settings

    • Click Settings icon (⚙️)
    • Navigate to Integrations tab

  2. Find Notion

    • Scroll to Notion tile
    • Click "Connect" button

  3. Authorize

    • Popup opens to Notion
    • Log in (if not already)
    • Select pages to share with HealUp
    • Click "Select pages"
    • Choose your task databases
    • Click "Allow access"

  4. Return to HealUp

    • Popup closes automatically
    • HealUp shows "Connected" status

Step 3: Configure Database Mapping​

Auto-Detection: HealUp automatically detects:

  • Title property
  • Status property (Not Started, In Progress, Complete)
  • Description property
  • Due date property

Manual Mapping (if needed):

  • Configure property mappings in Settings
  • Map Notion properties to HealUp fields
  • Save configuration

Step 4: Test Sync​

  1. Create test page in Notion database
  2. Wait 5-10 seconds
  3. Check HealUp - page should appear as task
  4. Complete in HealUp
  5. Check Notion - status should update

What Syncs​

✅ Database Properties:

  • Page title → Task name
  • Description/notes → Task description
  • Status property → Completion status
  • Due date → Task due date
  • Priority select → Task priority

✅ Sync Actions:

  • New page → Create task in HealUp
  • Complete task → Update status in Notion
  • Edit page → Update task in HealUp
  • Delete task → Archive page in Notion

What Doesn't Sync​

❌ Not Supported:

  • Page content/body (only title & properties)
  • Sub-pages (not treated as subtasks)
  • Relations to other databases
  • Formulas and rollups
  • Files and attachments

HealUp-Specific Features​

AI Breakdown:

  • Generate steps for Notion page
  • Steps stored in HealUp only
  • Complete in Execute Mode
  • Completion syncs to Notion status

Essential Properties:

Title: "Task Name" (title)
Status: Select with "Not Started", "In Progress", "Complete"

Optional Properties:

Description: Text or Rich Text
Due Date: Date
Priority: Select with "High", "Medium", "Low"
Tags: Multi-select

Status Property​

Typical Values:

  • "Not Started" or "To Do" → Not complete in HealUp
  • "In Progress" → Active in HealUp
  • "Complete" or "Done" → Completed in HealUp

HealUp auto-detects your status values from database schema.

Multiple Databases​

Can connect:

  • Personal Tasks database
  • Work Projects database
  • Goals database
  • etc.

Each syncs independently:

  • Separate sync configuration per database
  • Can enable/disable individually

Workflow​

In Notion: Organization

  • Database views (tables, boards, calendars)
  • Rich page content
  • Relations and rollups
  • Team collaboration

In HealUp: Execution

  • Pull overwhelming pages
  • Get AI breakdown of steps
  • Execute with Execute Mode
  • Let completion sync back

Best Practice: Notion for organization and planning, HealUp for starting and executing.

Task Selection​

Good candidates for HealUp:

  • ✅ Large, overwhelming tasks
  • ✅ Tasks with "In Progress" status stuck
  • ✅ Complex multi-step work
  • ✅ Tasks needing breakdown

Keep in Notion only:

  • ❌ Simple quick tasks
  • ❌ Reference pages
  • ❌ Team-dependent tasks
  • ❌ In-progress collaborative work

Multiple Status Workflows​

Custom Status Values:

Notion: "Backlog" | "Ready" | "Doing" | "Done"
HealUp maps:
- "Backlog", "Ready" → Not Complete
- "Doing" → In Progress  
- "Done" → Complete

Auto-detection works with any status names.

Filtered Views​

Coming Soon:

  • Sync only pages matching filters
  • Example: Status = "Ready" AND Priority = "High"
  • Reduces sync load

Bi-Directional AI Summary​

Future Feature:

  • Complete task in HealUp with AI steps
  • AI summary added to Notion page body
  • Team sees execution details

Can I use HealUp without Notion?​

Yes. Notion integration is optional.

Will this replace Notion?​

No. HealUp complements Notion. Use Notion for knowledge management, HealUp for task execution.

What happens if I disconnect?​

Tasks in HealUp remain but stop syncing. Reconnect anytime.

Can I sync multiple workspaces?​

Connect one workspace at a time. Switch by disconnecting and reconnecting different workspace.

Do linked databases work?​

Yes, as long as you share the source database with HealUp.

Ready to connect Notion?

Open HealUp Settings → and link your Notion databases.