Notion Integration
Zephyr documentation
How Notion Integration Works
Zephyr can add pages to Notion databases as a workflow action. When a workflow triggers, the 'Add to Notion' action creates a new page in a specified Notion database with properties derived from the email or AI-processed result.
Setting Up Notion
1) Go to https://www.notion.so/my-integrations and create a new integration.
2
Set the redirect URL to your Zephyr API URL + /connectors/notion/callback.
3
Copy the Client ID and Client Secret (under OAuth settings).
4
Add them as SSM parameters: /zephyr/prod/notion-client-id and /zephyr/prod/notion-client-secret.
5
Deploy Zephyr.
6
In Settings > Connected Services, click Connect on the Notion card.
7
Important: share the target Notion database with your integration in Notion.
Creating Notion Workflows
Example: 'When I get an email with action items, extract them and add to my Notion task database'. The AI generates a workflow with ai.extract_actions followed by notion_add with the database ID. You need the Notion database ID from the database URL.