Getting Started
Getting Started with Outrun
Get your first data sync running in under 10 minutes. This guide will walk you through creating an account, connecting your first source, and setting up a destination.
Step 1: Create Your Account
Your Outrun account is personal to you and designed for security and simplicity.
π Why Magic Links?
We use magic links instead of passwords because we don't want to store your passwords. This approach also sets us up perfectly for the SSO features we have planned for later.
- Visit app.getoutrun.com
- Enter your email address
- Check your inbox for the magic link
- Click the link to access your account
That's it! You're now logged into Outrun.
Step 2: Create Your First Source
Sources are where your data comes from. We currently support 15 different sources.
- Navigate to Sources in the left sidebar
- Click "Add Source"
- Select your source type - for this guide, we'll use HubSpot
π‘ Pro Tip
Start with a source that has data you're familiar with. HubSpot is great for testing because it has clear contact and company structures.
Step 3: Authenticate Your Source
Next, you'll need to connect Outrun to your HubSpot account.
- Select your token type - you can have multiple tokens, but add one to get started
- Click "Authenticate with OAuth"
- Complete the OAuth flow in the popup window
- Grant permissions when prompted
π What We Store
- β’ Your OAuth access token (encrypted)
- β’ A refresh token so we can pull data continuously
- β’ Permission scopes you've granted
This allows us to keep your data in sync automatically without you having to re-authenticate.
Step 4: Name Your Source
We allow you to name your sources because some organizations have multiple instances of the same application.
- Enter a descriptive name (e.g., "HubSpot Production", "HubSpot EMEA", "Main HubSpot")
- Add a description (optional but recommended)
- Click "Save Source"
Step 5: Complete Your Integration
Your source will start syncing immediately after setup.
β‘ Rate Limiting
Outrun uses standard rate limiting to manage requests at a volume the service can handle. If you have higher API limits, let us knowβwe're interested in how this feature might offer some customization options.
What happens during sync:
- Initial data pull - We fetch all existing data from your source
- Stream creation - Raw data goes into a
_stream
(all data we ever receive) - Consolidation - Data gets merged and cleaned into
_consolidate
- Standardization - Data transforms into standardized objects:
- Facts - Events and activities
- Organizations - Companies and accounts
- People - Contacts and users
- Relationships - Connections between entities
Step 6: Wait for Initial Sync
β±οΈ Be patient! Depending on your company size, initial syncs can take time. Systems with lots of data need more time to process.
β οΈ Important
We recommend waiting for your initial sync to complete before adding your first destination. This ensures clean, complete data transfer.
You can monitor progress in:
- The Sources dashboard
- Sync logs and status indicators
- Real-time sync statistics
Step 7: Add Your First Destination
Once your source sync is complete, add where you want the data to go.
- Navigate to Destinations in the sidebar
- Click "Add Destination"
- Select your destination type (Salesforce, data warehouse, etc.)
- Follow the same authentication process as with sources
- Name your destination descriptively
- Configure field mappings (optional - we provide smart defaults)
Step 8: Automatic Sync Begins
π You're done! Outrun now listens for changes to your standardized facts, organizations, people, and relationships, then alerts your destination system to changes automatically.
What happens next:
- Real-time change detection
- Automatic data transformation
- Continuous sync between systems
- Conflict resolution and deduplication
Monitoring Your Sync
Track your data synchronization through:
- Dashboard overview - High-level sync statistics
- Sync logs - Detailed operation history
- Error alerts - Immediate notification of issues
- Data lineage - Track data flow between systems
Next Steps
π Core Concepts
Learn about standardized objects, data transformation, and Outrun's philosophy.
Learn More βπ Browse Integrations
Explore all supported sources and destinations for your data ecosystem.
View All βNeed Help?
- Discord Community: Join our Discord for real-time support
- Email Support: support@getoutrun.com
- Documentation: Browse our full documentation
π Congratulations! You've successfully set up your first data sync with Outrun.