Skip to main content

​
Overview

The Notion integration enables automatic account creation when your ops team adds customers to a Notion database, bridging operations and customer success workflows. [SCREENSHOT: Notion integration connected]

​
Benefits

Ops-Friendly

Ops team works in familiar Notion interface

Auto-Trigger CS

New database row → Account created automatically

Flexible Structure

Map any database structure to Thread

No CRM Required

Alternative to HubSpot for smaller teams

​
Setup Instructions

1

Connect Notion OAuth

Connectors → Notion → “Connect” → Select workspace → Authorize
2

Grant Database Access

Select databases Thread can access:
  • Choose “Customer Accounts” database
  • Grant read permissions
  • Confirm authorization
[SCREENSHOT: Notion database selection screen]
3

Select Database to Monitor

Connectors → Notion Settings:
  • Choose database from dropdown
  • Configure monitoring frequency (real-time recommended)
4

Map Database Fields

Map Notion columns to Thread fields:
Notion Column → Thread Field
├── Company Name → company_name
├── ARR → arr
├── Close Date → close_date
├── PM Email → primary_contact_email
├── AE → ae_email
└── Notes → raw_payload
[SCREENSHOT: Field mapping interface]
5

Choose Template

Select default template for auto-created accounts
6

Test with Sample Row

Add test row to Notion → Verify account created in Thread → Delete test
7

Enable Auto-Creation

Toggle ON → Monitor first few accounts → Adjust mappings if needed

​
Workflow Example

1. Ops adds row to "Customer Accounts" Notion database
   - Company: Acme Corp
   - ARR: $50k
   - Close Date: 2024-03-15
   - PM: jane@acme.com
   - AE: ae@company.com
   ↓
2. Notion webhook fires to Thread
   ↓
3. Thread fetches row data via API
   ↓
4. Thread creates account with mapped data
   ↓
5. Handoff Q&A generated from Notes column
   ↓
6. Handoff email sent to AE
   ↓
7. Account appears in Thread

​
Notion Database Setup

Required columns:
  • Company Name (text)
  • ARR (number, format: currency)
  • Close Date (date)
  • Primary Contact Email (text/email)
  • AE Email (text/email)
Optional columns:
  • Industry (select)
  • Company Size (select)
  • Use Case (text/long text)
  • Notes (text/long text)
  • Status (select: New, In Progress, Complete)
[SCREENSHOT: Example Notion database structure]

​
Column Types

Notion TypeThread Interpretation
TextString
NumberNumeric (ARR)
DateDate format
SelectMapped to categories
Multi-selectComma-separated list
EmailEmail validation applied
Long textRaw payload for AI

​
Best Practices

Standardize Format

Use consistent company naming and data formats

Required Fields First

Ensure all required fields filled before adding row

Rich Notes Column

Detailed notes → Better AI handoff generation

Status Column

Track which rows have been processed

Archive Old Rows

Move completed accounts to archive database

Document Process

Train ops team on required fields and format

​
Troubleshooting

Cause: Thread doesn’t have access to databaseSolution: Reconnect and grant access to specific database
Cause: Missing required fields or wrong databaseSolution: Verify all required fields populated, check database selection
Cause: Field mappings incorrectSolution: Review and fix field mappings in settings

​
Next Steps

Create Accounts

Understand account creation process

HubSpot Integration

Alternative CRM integration