Account Creation Overview
Accounts represent your customers in Thread. Each account contains:
- Customer company information
- Assigned template and milestones
- Action history and status
- Handoff Q&A and context
- CSM assignment and ownership
[SCREENSHOT: Account creation form]
Caption: Create accounts manually or sync from HubSpot
Manual Account Upload
When to Use
- Initial onboarding to Thread
- Customers not yet in CRM
- Quick account creation for testing
- Bypassing automation workflows
Step-by-Step Process
Navigate to Manual Upload
From the main menu: Accounts → Manual Upload[SCREENSHOT: Navigation to manual upload page]
Enter Company Information
Required fields:
- Company Name
- ARR (Annual Recurring Revenue)
- Close Date
- Primary Contact Name
- Primary Contact Email
Optional fields:
- Industry
- Company Size
- Website
- Notes
Select Template
Choose the onboarding template to apply:
- Standard SaaS Onboarding
- Enterprise Implementation
- Quick Start
- Custom templates
Templates are immutable snapshots. The entire config is copied to the account at creation time.
Assign Account Executive
Enter AE email for handoff:
- AE receives handoff link via email
- AE reviews AI-generated Q&A
- AE assigns CSM before submitting
The AE email doesn’t need to be a Thread user. They receive a tokenized link that works for anyone.
Add Raw Payload (Optional)
Include additional context for AI generation:
- CRM notes
- Deal information
- Sales conversations
- Customer research
Thread uses this to generate better handoff Q&A. Create Account
Click “Create Account” to trigger:
- Account created in database
- Template instantiated as milestones
- Handoff Q&A generated by AI
- Email sent to AE with handoff link
- Account appears in accounts list (pending handoff)
HubSpot Integration
Auto-Create from Deals
Once HubSpot is connected, accounts can be created automatically:
Trigger: Deal reaches “Closed Won” stage
What happens:
- Thread fetches deal data from HubSpot
- Extracts company, contact, ARR, close date
- Creates account with configured template
- Generates handoff Q&A from CRM data
- Sends handoff email to deal owner
[SCREENSHOT: HubSpot integration settings]
Caption: Configure which deal stage triggers account creation
Benefits
- ✅ No manual data entry
- ✅ Always up-to-date customer info
- ✅ Automatic handoff initiation
- ✅ Audit trail from CRM to CS
Configuration
- Navigate to Connectors → HubSpot
- Click “Connect” and authorize OAuth
- Select deal stage for account creation
- Choose default template to apply
- Map custom fields (optional)
- Test with a sample deal
- Enable auto-creation
Test with a dummy deal first! Auto-creation will trigger for all deals reaching the configured stage.
Notion Integration
Auto-Create from Database
Create accounts when new rows added to Notion database:
Setup:
- Connect Notion integration
- Select database to monitor
- Map database fields to account fields
- Choose template to apply
- Test with a sample row
- Enable automation
Example mapping:
Notion Database Field → Thread Account Field
├── Company Name → company_name
├── ARR → arr
├── Close Date → close_date
├── PM Email → primary_contact_email
├── AE → ae_email
└── Notes → raw_payload
[SCREENSHOT: Notion database integration setup]
Caption: Map Notion database columns to Thread account fields
Account Fields Explained
Required Fields
What: Customer company display nameExamples:
- “Acme Corporation”
- “Acme Corp (Enterprise)”
- “Acme - North America Division”
Best practices:
- Use official company name
- Add segment in parentheses if needed
- Be consistent with CRM
ARR (Annual Recurring Revenue)
What: Contract value in dollarsExamples:
- $50,000
- $250,000
- $1,200,000
Best practices:
- Use annual contract value
- Round to nearest thousand
- Include expansion revenue
- Don’t include one-time fees
What: When the deal was wonFormat: YYYY-MM-DDExamples:Best practices:
- Use actual close date, not start date
- Consistent with CRM
- Used for analytics and reporting
Optional Fields
What: Customer industry/verticalExamples:
- Healthcare
- Financial Services
- Manufacturing
- Technology
Use: Template customization, segmentation, analytics
What: Employee count rangeOptions:
- 1-50 (SMB)
- 51-500 (Mid-Market)
- 501-5000 (Enterprise)
- 5000+ (Global Enterprise)
Use: Segment for template selection, resource allocation
What: Additional contextExamples:
- Deal notes from AE
- Special requirements
- Known risks or challenges
- Competitive intel
Use: CSM context, AI handoff generation
Account Status
Accounts progress through these statuses:
| Status | Meaning | Next Step |
|---|
| pending_handoff | Created, waiting for AE handoff | AE completes handoff form |
| active | Onboarding in progress | CSM manages implementation |
| at_risk | Issues or delays | CSM intervention needed |
| completed | Successfully launched | Transition to steady-state CS |
| churned | Customer left | Archive for analysis |
[SCREENSHOT: Account status badges]
Caption: Status indicators help prioritize which accounts need attention
Status Management
CSMs can update status manually:
- Navigate to account detail page
- Click status dropdown
- Select new status
- Add note explaining change (optional)
- Status updates customer portal (for some statuses)
Mark accounts “at_risk” proactively when you sense issues. Don’t wait until it’s a crisis!
Account Assignment
CSM Assignment
Automatic (via handoff):
- AE selects CSM during handoff
- CSM receives notification
- CSM auto-assigned to account
Manual:
- Navigate to account
- Click “Assign CSM”
- Select from organization CSMs
- Optionally notify CSM
- Save assignment
[SCREENSHOT: CSM assignment dropdown]
Caption: Assign or reassign CSMs from the account detail page
Reassignment
When CSMs change:
- Navigate to account
- Click current CSM name
- Select new CSM
- Choose notification options:
- Notify new CSM
- Notify customer
- Add transition note
- Confirm reassignment
Customer sees CSM name in portal. If you reassign, consider sending a personal introduction email from the new CSM.
Bulk Account Upload
For migrating large customer lists:
CSV Import
Format:
company_name,arr,close_date,primary_contact_name,primary_contact_email,ae_email,template_name
Acme Corp,50000,2024-01-15,Jane Smith,jane@acme.com,ae@company.com,Standard SaaS
Beta Inc,120000,2024-02-01,John Doe,john@beta.com,ae@company.com,Enterprise
Process:
- Navigate to Accounts → Bulk Upload
- Download CSV template
- Fill in customer data
- Upload completed CSV
- Review preview and validation errors
- Confirm import
- Accounts created and handoff emails sent
Bulk upload supports up to 100 accounts at once. For larger imports, contact support.
Account Filtering and Search
Find accounts quickly:
Filters
By Status
By CSM
By Milestone
By Date
- Active
- Pending Handoff
- At Risk
- Completed
- Churned
- My Accounts
- Unassigned
- Specific CSM
- In Kickoff
- In Implementation
- In Training
- In Launch
- Created this week
- Close date range
- Last activity
Search
Search accounts by:
- Company name
- Primary contact name
- Primary contact email
- ARR range
- Template name
[SCREENSHOT: Account list with filters applied]
Caption: Filter and search to focus on accounts needing attention
Next Steps