Notion
Sync EarlySEO articles to a Notion database using OAuth and field mapping.
The Notion integration uses OAuth to connect your Notion workspace and sync articles into a database you choose. You control which Notion properties map to EarlySEO article fields.
Prerequisites
- A Notion workspace with a database for blog articles
- Permission to connect integrations in your Notion workspace
- An EarlySEO account
Setup
1. Start the OAuth flow
- Go to Integrations in your EarlySEO dashboard
- Click Add Integration and select Notion
- Click Connect with Notion you will be redirected to Notion to authorize
2. Authorize EarlySEO
In Notion's authorization screen:
- Select the workspace to connect
- Grant access to the databases EarlySEO should write to (or select "All pages")
- Click Allow Access
- You will be redirected back to EarlySEO
3. Select a database
After authorization, EarlySEO loads your available Notion databases. Choose the database where articles will be synced (e.g. "Blog Articles").
If no databases appear, click Refresh Notion's API may take a moment to sync access.
4. Map fields
Map your Notion database properties to EarlySEO article fields:
| EarlySEO Field | Recommended Notion Property Type |
|---|---|
| Title | Title property (required) |
| Slug | Text / Rich Text |
| Meta Description | Text / Rich Text |
| Publish Date | Date |
| Article (Title + Content) | Title or Rich Text |
Required: At least one property must be mapped to Title or Article.
EarlySEO auto-detects common field names (e.g. "Title", "Slug", "Date") and pre-fills the mapping for you.
5. Name and save
- Enter a name for the integration (e.g. "My Blog Notion DB")
- Click Create Integration
EarlySEO will now sync new articles to your Notion database.
Field Notes
- Article field maps both the title and full content body into a single Notion page
- Slug maps to a plain text property ensure your database has one if you need URL slugs
- Rich text fields in Notion receive Markdown-formatted content
Troubleshooting
Databases not loading
- Click Refresh Databases the Notion API sometimes needs a moment
- Ensure EarlySEO has access to the target database (re-authorize and re-grant access)
"Please map at least one field to Title or Article"
- Open the field mapping section and assign at least one Notion property to Title or Article
Content not syncing
- Check if the Notion integration still has access re-authorize if the token expired