Notion & Todoist Integration

Sync Verk with Notion for documentation and Todoist for personal task management. Keep your knowledge base, personal to-dos, and team projects aligned.

Notion Integration

Quick Setup

Connect Verk to your Notion workspace:

1. Navigate to Integrations

• Go to Settings → Integrations
• Find Notion in available integrations
• Click Connect to Notion

2. Authorize Notion

• Sign in to Notion
• Select pages and databases to share
• Review requested permissions
• Click Allow Access

3. Configure Database Sync

• Select Notion databases to sync
• Map database properties to Verk fields
• Choose sync direction
• Set default project for Notion tasks
• Save configuration

4. Test Connection

• Create a page in connected Notion database
• Verify task appears in Verk
• Update task in Verk
• Check changes sync to Notion

What Syncs with Notion

Notion Databases → Verk Tasks:

• Page title → Task title
• Page content → Task description
• Status property → Task status
• Assignee → Task assignee
• Due date → Task due date
• Tags → Task labels
• Checkboxes → Task custom fields
• Multi-select → Task tags

Verk Tasks → Notion Pages:

• Task title → Page title
• Task description → Page content blocks
• Status → Status property
• Assignee → Person property
• Due date → Date property
• Tags → Multi-select property
• Attachments → File properties

Notion Database Configuration

Property Mapping:

Map Notion database properties to Verk fields:

1. Go to Settings → Integrations → Notion
2. Select database to configure
3. Click Property Mapping
4. For each Notion property, choose corresponding Verk field:

Notion Property  → Verk Field
─────────────────────────────────────
Status    → Task Status
Assignee    → Task Assignee
Due Date    → Task Due Date
Priority    → Task Priority
Tags     → Task Labels
Project    → Verk Project

5. Save mapping configuration

Supported Property Types:

• Text → Text fields
• Number → Number fields
• Select → Dropdown fields
• Multi-select → Tags/labels
• Date → Date fields
• Person → Assignee
• Checkbox → Boolean fields
• URL → URL fields
• Email → Email fields
• Phone → Phone fields
• Files → Attachments

Notion Use Cases

Documentation Hub

Scenario: Sync project documentation between Notion and Verk

Setup:

1. Create "Documentation" database in Notion
2. Add properties: Status, Owner, Category, Priority
3. Connect to Verk "Documentation" project
4. Map properties to Verk fields

Workflow:

1. Team member creates doc page in Notion
2. Page syncs to Verk as task
3. Task assigned for review
4. Completion marks doc as "Published"
5. Status syncs back to Notion

Result: Unified view of documentation status

Knowledge Base Tasks

Scenario: Turn Notion pages into actionable tasks

Setup:

1. Tag Notion pages with "Action Required"
2. Auto-create Verk tasks for tagged pages
3. Assign based on page owner
4. Track completion in both systems

Workflow:

1. Meeting notes in Notion include action items
2. Pages tagged "Action Required"
3. Tasks auto-created in Verk
4. Team completes tasks
5. Completion removes tag in Notion

Result: Action items never lost in documentation

Product Roadmap Sync

Scenario: Maintain roadmap in Notion, track in Verk

Setup:

1. Build roadmap database in Notion
2. Properties: Quarter, Status, Owner, Priority
3. Sync to Verk "Product Roadmap" project
4. Auto-create tasks for approved features

Workflow:

1. Product team maintains roadmap in Notion
2. Features marked "Approved" sync to Verk
3. Engineering team breaks down into tasks
4. Progress updates sync to Notion
5. Stakeholders see status in Notion

Result: Product and engineering aligned

Notion Page Creation

Create Notion pages from Verk tasks:

Automatic Page Creation:

Trigger: Task created with "Documentation" tag
Action: Create Notion page in Documentation database
Content: Task description as page content
Properties: Map task fields to database properties

Template Support:

• Use Notion database templates
• Auto-apply templates based on task type
• Preserve formatting and structure
• Include linked databases

Rich Content Sync:

• Task descriptions → Notion blocks
• Markdown formatting preserved
• Lists and checkboxes converted
• Code blocks maintained
• Links preserved

Todoist Integration

Quick Setup

Connect your Todoist account:

1. Navigate to Integrations

• Go to Settings → Integrations
• Find Todoist in available integrations
• Click Connect to Todoist

2. Authorize Todoist

• Sign in to Todoist
• Review permissions
• Click Agree

3. Configure Projects

• Map Todoist projects to Verk projects
• Choose sync direction (bi-directional recommended)
• Set label mappings
• Configure priority mappings
• Save settings

4. Test Sync

• Create task in Todoist
• Verify it appears in Verk
• Complete task in Verk
• Check completion syncs to Todoist

What Syncs with Todoist

Bi-Directional Sync:

• Task name ↔ Task title
• Task description ↔ Task description
• Due date ↔ Task due date
• Priority → Task priority (P1-P4 → High/Medium/Low)
• Labels ↔ Task tags
• Project ↔ Verk project
• Sections → Task groups
• Subtasks ↔ Subtasks
• Comments ↔ Task comments
• Completion status ↔ Task status

Todoist-Specific Features:

• Recurring tasks → Verk recurring tasks
• Filters → Verk saved filters
• Karma → Tracked separately (view in Todoist)
• Natural language → Parsed for due dates and priorities

Priority Mapping

Todoist's 4-level priority system maps to Verk:

Todoist Priority  → Verk Priority
─────────────────────────────────────
P1 (Urgent)   → High
P2 (High)   → High
P3 (Medium)   → Medium
P4 (Low/None)  → Low

Customize mapping:

1. Go to Integration Settings → Priority Mapping
2. Choose how P1-P4 map to your Verk priorities
3. Set default priority for tasks without priority
4. Save configuration

Todoist Use Cases

Personal + Team Task Management

Scenario: Manage personal tasks in Todoist, team work in Verk

Setup:

1. Sync only specific Todoist projects to Verk
2. Keep "Personal" project Todoist-only
3. "Work" project syncs bi-directionally
4. Filter views in both tools

Workflow:

1. Personal tasks stay in Todoist
2. Work tasks created in either tool
3. Team collaboration happens in Verk
4. Personal view in Todoist, team view in Verk

Result: Best of both worlds

Inbox Processing

Scenario: Capture in Todoist, organize in Verk

Setup:

1. Use Todoist as quick capture inbox
2. Todoist Inbox syncs to Verk "Triage" project
3. Process and organize in Verk
4. Moving to Verk project removes from Todoist Inbox

Workflow:

1. Quick add to Todoist throughout day
2. Tasks appear in Verk Triage
3. Review and categorize in Verk
4. Organized tasks move to proper projects
5. Inbox stays clean in both systems

Result: Fast capture, thoughtful organization

Habit Tracking

Scenario: Track daily habits and recurring tasks

Setup:

1. Create "Daily Habits" project in Todoist
2. Set recurring tasks (e.g., "Exercise" every day)
3. Sync to Verk for visibility
4. Mark complete in either tool

Workflow:

1. Recurring tasks appear daily
2. Complete in Todoist or Verk
3. Streak tracking in Todoist
4. Team sees commitment in Verk (optional)

Result: Consistent habit tracking

Label Sync

Todoist labels map to Verk tags:

Automatic Mapping:

Todoist Label  → Verk Tag
─────────────────────────────────────
@home    → Home
@work    → Work
@urgent    → Urgent
@waiting    → Waiting

Custom Mapping:

1. Go to Label Mapping in integration settings
2. Map Todoist labels to Verk tags
3. Create new tags automatically or map to existing
4. Save configuration

Smart Filtering:

• Filter Verk tasks by Todoist labels
• Use Verk tags to add Todoist labels
• Combine labels for advanced filtering
• Cross-tool search and organization

Recurring Tasks

Todoist's powerful recurring task syntax syncs to Verk:

Supported Recurrence Patterns:

Todoist Pattern   → Verk Recurrence
──────────────────────────────────────────────
every day     → Daily
every weekday    → Weekdays only
every Monday    → Weekly (Monday)
every 2 weeks    → Bi-weekly
every month    → Monthly
every year    → Yearly

Smart Dates:

• "tomorrow" → Next day
• "next week" → Following week
• "in 3 days" → Calculated date
• All sync accurately to Verk

Migration Tools

Migrating from Todoist to Verk

Bulk Import Process:

1. Export from Todoist

• Go to Todoist Settings → Backups
• Download CSV export
• Save to your computer

2. Import to Verk

• Go to Settings → Import & Export
• Select Import from Todoist
• Upload CSV file
• Map Todoist projects to Verk projects
• Choose handling for:
• Completed tasks (import or skip)
• Archived tasks (import or skip)
• Labels and tags (map or create new)

3. Review and Confirm

• Preview import mapping
• Adjust project assignments
• Confirm field mappings
• Start import

4. Post-Import

• Review imported tasks
• Fix any mapping issues
• Archive old Todoist data
• Enable ongoing sync if desired

Migrating from Notion to Verk

Database Export:

1. Export Notion Database

• Open Notion database
• Click ⋯ (three dots) → Export
• Choose CSV & Markdown format
• Download export

2. Import to Verk

• Go to Settings → Import & Export
• Select Import from Notion
• Upload exported file
• Map Notion properties to Verk fields:

Notion → Verk Mapping
─────────────────────
Status → Task Status
Assignee → Task Owner
Tags → Task Labels
Due → Due Date

• Choose target project
• Start import

3. Content Conversion

• Notion markdown → Verk description
• Nested pages → Subtasks or linked tasks
• Page links → Task links
• Databases → Projects

4. Enable Live Sync

• After import, connect Notion integration
• Enable bi-directional sync
• Future changes stay synchronized

Troubleshooting

Notion Sync Issues

Issue: Notion pages not syncing

Solutions:

• Verify integration has access to database
• Check page is in connected database
• Ensure database has required properties
• Re-authorize Notion integration
• Check for Notion API rate limits

Issue: Property mapping not working

Solutions:

• Verify property types are compatible
• Check for required fields without values
• Review field name matching (case-sensitive)
• Recreate property mapping
• Test with simple database first

Todoist Sync Issues

Issue: Tasks not syncing from Todoist

Solutions:

• Verify project is mapped to Verk
• Check task is in synced project
• Ensure Todoist integration is active
• Manually trigger sync
• Check for duplicate tasks

Issue: Recurring tasks creating duplicates

Solutions:

• Review recurrence pattern interpretation
• Check sync frequency settings
• Disable and re-enable integration
• Use Verk-native recurrence instead

Best Practices

Notion Integration

Database Structure:

• Use consistent property names across databases
• Include Status property for workflow tracking
• Add Assignee for task ownership
• Use Multi-select for tags and categories

Content Organization:

• Keep task descriptions concise
• Use Notion for detailed documentation
• Link to comprehensive Notion pages from Verk
• Maintain single source of truth per item type

Todoist Integration

Project Organization:

• Sync only work-related Todoist projects
• Keep personal projects separate
• Use labels consistently
• Set realistic due dates

Sync Strategy:

• Start with one-way sync to test
• Enable bi-directional after validation
• Review sync conflicts regularly
• Clean up completed tasks periodically

Related Documentation

• Integration Overview - General integration concepts
• Data Migration - Comprehensive migration guide
• Custom Fields - Field mapping setup
• Import & Export - Bulk data operations
• API Reference - Build custom integrations

---

Notion and Todoist integrations bring your documentation, personal tasks, and team work into one unified system.