ChefDesk - Complete solution for restaurants
Back to SOP Manual
Integration Guide

Connect Notion with ChefDesk SOP Manual

Sync your checklists, tasks, and process documents bidirectionally between ChefDesk and Notion. Keep your team aligned across both platforms.

What You Can Sync

Checklists

Daily opening/closing procedures, shift checklists with completion status and shift assignments.

Push| Pull

Tasks

Kanban tasks with status, priority, descriptions, due dates, and assignment tracking.

Push| Pull

Processes

SOP documents, process guides, and training materials with content and document type.

Push| Pull
Part 1

Set Up on Notion

1

Create a Notion Integration

Go to notion.so/my-integrations and click '+ New integration'. Give it a name like 'ChefDesk SOP Sync', select your workspace, and click Submit.

Choose 'Internal integration' type
Select the workspace where your databases will live
Under Capabilities, ensure 'Read content', 'Update content', and 'Insert content' are enabled
2

Copy the Integration Token

After creating the integration, you'll see an 'Internal Integration Secret' (starts with ntn_ or secret_). Copy this token — you'll need it in ChefDesk.

Keep this token secure — it grants full access to shared pages
You can regenerate the token anytime if compromised
3

Create Notion Databases

Create separate databases in Notion for each entity you want to sync. You'll need up to three databases: one for Checklists, one for Tasks, and one for Processes.

Create a full-page database (not inline) for best results
Each database needs at least a 'Name' (title) property — ChefDesk will auto-create other required columns
You can organize them all on a single Notion page for easy access
4

Share Databases with Your Integration

Open each database, click the ••• menu (top-right), go to 'Connections', and add your 'ChefDesk SOP Sync' integration. This grants the integration permission to read and write data.

You must share each database individually
Without sharing, the API will return a 'not found' error
The integration only accesses databases you explicitly share
5

Copy Each Database ID

Open a database in Notion as a full page. The URL will look like: notion.so/your-workspace/[DATABASE_ID]?v=... — copy the 32-character ID between the last '/' and the '?'.

The ID is 32 characters with no dashes (e.g., a1b2c3d4e5f6...)
You can also find it via 'Copy link' and extracting from the URL
You'll need a separate ID for each entity (checklists, tasks, processes)
Part 2

Configure in ChefDesk

1

Navigate to SOP Manual Settings

Open the SOP Manual from your Dashboard or Tools page. Click on the 'Settings' tab in the top navigation bar.

You need to be logged in to access the SOP Manual
The Settings tab is the last tab in the navigation
2

Enable Notion Integration

In the Settings tab, find the 'Notion Integration' section. Toggle the integration to active, then paste your Notion Integration Token in the API Key field.

The token is encrypted and stored securely
You can update or revoke the token at any time
3

Add Your Database IDs

Paste the Database IDs you copied from Notion into the corresponding fields: Checklists Database ID, Tasks Database ID, and Processes Database ID. You only need to fill in the ones you want to sync.

Leave a field empty if you don't want to sync that entity
The sync button will only appear for entities with a configured Database ID
4

Save and Start Syncing

Click 'Save Integration' to store your settings. Now go to any tab (Checklists, Tasks, or Processes) and you'll see a 'Notion Sync' button in the header. Use it to Push data to Notion or Pull data from Notion.

Push: Sends your ChefDesk data to Notion (creates new pages)
Pull: Reads data from Notion and updates your ChefDesk records
ChefDesk auto-creates required columns in your Notion database on first sync

Auto-Created Notion Properties

ChefDesk automatically adds these columns to your Notion databases on the first sync. You don't need to create them manually.

Checklists DB

  • Name — Item title
  • Checklist — Parent checklist name
  • Status — To Do / In Progress / Done
  • Shift — all / morning / evening

Tasks DB

  • Name — Task title
  • Status — To Do / In Progress / Review / Done
  • Priority — low / medium / high
  • Description — Task details
  • Due Date — Deadline

Processes DB

  • Name — Document title
  • Type — markdown / pdf / word
  • Content — First 2000 chars as body

Tips & Troubleshooting

Common Issues

  • "Not found" error: Make sure the database is shared with your integration (Step 4 in Notion setup).
  • "Unauthorized" error: Your integration token may be expired or incorrect. Regenerate it in Notion.
  • Missing columns: ChefDesk auto-creates them on first push — run a push first before pulling.
  • Pull not updating: Tasks are matched by title. Ensure the task name in Notion matches exactly.

Pro Tips

  • Push first, then pull: Always push your data initially to populate Notion with the correct schema.
  • Use full-page databases: Inline databases within pages may not work correctly with the API.
  • Keep titles consistent: The pull sync matches records by name — avoid renaming items in only one platform.
  • One integration, multiple DBs: You only need one Notion integration token for all three database types.

Ready to Connect?

Head to your SOP Manual Settings tab and set up the integration in under 5 minutes.

Open SOP Manual