Notion Integration Setup
Create a Notion integration and configure database access
This guide walks through creating a Notion integration and connecting it to your calendar database.
Step 1: Create Integration
Create New
Click New integration
Configure
- Name:
Calendar Sync - Type: Internal
- Associated workspace: Select your workspace
- Logo: Optional
Submit
Click Submit to create the integration
Step 2: Configure Capabilities
After creating the integration, configure its capabilities. Only content capabilities are required—other capabilities (comments, user information) can remain disabled.
Content Capabilities
| Capability | Status |
|---|---|
| Read content | Enabled (required) |
| Update content | Enabled (required) |
| Insert content | Enabled (required) |
Click Save changes.
Step 3: Copy Integration Token
- On the integration page, find Internal Integration Secret
- Click Show then Copy
- Save this token securely
Step 4: Connect to Database
The integration needs explicit access to your calendar database.
Open Database
Open your Notion calendar database as a full page
Open Menu
Click the ... menu in the top right
Add Connection
Go to Connections (or Add connections)
Select Integration
Find and select your Calendar Sync integration
Confirm
Click Confirm to grant access
Database Schema
Your database should have properties for calendar events. The setup wizard will help map your existing properties.
Recommended Properties
| Property | Type | Purpose |
|---|---|---|
| Name/Title | Title | Event title (required) |
| Date | Date | Event date/time with end date (required) |
| Description | Text | Event details |
| Location | Text | Event location |
| Reminders | Number | Minutes before event for reminder |
Required Property for Sync
The sync creates one additional property automatically:
| Property | Type | Purpose |
|---|---|---|
| GCal Event ID | Text | Links events between systems |
Note
You can create this manually or let the setup wizard create it. Hide it in your views for a cleaner look.
Environment Variables
After completing this setup, you'll have the Internal Integration Secret:
| Variable | Description | Your Value |
|---|---|---|
| Your integration secret (starts with secret_) |
Notion uses an internal integration (API token), not OAuth. You'll enter this token during the setup wizard.
Troubleshooting
Security Notes
- Integration tokens have full access to connected pages
- Only connect the integration to databases it needs
- Don't share your integration token publicly
- Regenerate the token if compromised