Rock-Solid Reliability

The platform has been humming along with no major incidents since the 2.0 release. Our infrastructure has handled traffic smoothly, webhooks are firing on time, and email processing continues to run without a hitch.

Under the Hood

We’ve kept the foundation current with regular dependency and security updates. Nothing flashy — just the kind of quiet maintenance work that keeps a platform healthy and secure.

What This Means for You

Sunnybox is a mature, stable product. If you’re building email features into your app, the API you integrate with today will keep working reliably tomorrow. That’s the goal, and we’re delivering on it.

Get in Touch

Questions or ideas? Reach out at support@sunnybox.io.

Happy building!

What’s New in 2.0?

Simpler API, Better Performance

We’ve streamlined our API to make it easier to use and faster to respond:

• 30% faster response times across all endpoints
• Cleaner URLs without version numbers (your integrations stay stable)
• 50% reduction in API calls needed for common operations
• 2x faster email processing in background jobs

Choose Your Webhooks

Tired of getting flooded with webhooks you don’t need? Our new event system lets you pick exactly what you want to know about:

• Subscribe to specific events like “message.received” or “job.failed”
• Reduce webhook traffic by up to 90% by only getting what matters
• Discover all available events with our new events endpoint
• Filter by provider to only get events for specific email accounts

For example, if you only care about new messages and failed sends, just subscribe to those two events. No more filtering through noise.

Full Draft Support

Email drafts are now fully supported, making Sunnybox perfect for email clients and CRM systems:

• Save drafts with all formatting and attachments preserved
• Edit and update drafts as many times as needed
• Send when ready with a single API call
• Automatic sync with Gmail and IMAP providers

Enterprise-Grade Security

We’ve significantly enhanced security across the platform:

• Webhook signatures to verify requests are really from Sunnybox
• Granular permissions to control exactly what each API key can do
• Encrypted provider credentials with industry-standard encryption
• Comprehensive audit logging for compliance requirements

Better Email Management

Managing emails is now more powerful and intuitive:

• Reply and forward emails with a single API call
• Move messages between folders effortlessly
• Batch operations to process multiple emails at once
• Thread tracking to keep conversations organized
• Advanced search with full IMAP search syntax support

Perfect For

Building Email Features

If you’re adding email capabilities to your SaaS product, Sunnybox 2.0 makes it simple:

• Connect any email provider through one unified API
• Process incoming emails automatically
• Send responses and handle threads programmatically

Creating Email Clients

Developers building email applications will love:

• Full draft support with auto-save
• Real-time webhook notifications
• Thread management and conversation tracking
• Fast, powerful search capabilities

Automating Workflows

Connect email to your automation platform:

• Trigger actions based on specific emails
• Move and organize messages programmatically
• Extract and process email data
• Batch operations for efficiency

Upgrading to 2.0

For Existing Customers

Your current integration continues to work! To use the new features:

1. Update your base URL - Remove /v1 from your API calls
2. Select your events - Choose only the webhooks you need
3. Add webhook signatures - Verify requests are from Sunnybox (recommended)

The changes are minimal and backwards-compatible for most operations.

For New Customers

Getting started is straightforward:

1. Sign up at sunnybox.io
2. Connect your email provider (Gmail OAuth or any IMAP server)
3. Make your first API call using our documentation

Why This Matters

Version 2.0 isn’t just about new features - it’s about making email integration reliable and scalable:

• Reduced webhook noise - Only get the events you care about
• Faster operations - 30% improvement in response times
• Better reliability - Enhanced error handling and retry logic
• Cleaner integration - Simpler URLs and consistent responses

Technical Highlights

For the technically curious, here’s what’s under the hood:

• Complete architectural refactoring for better maintainability
• Domain-driven design with proper separation of concerns
• Cursor-based pagination for efficient data retrieval
• HMAC-SHA256 webhook signatures for security
• Event-driven architecture with selective subscriptions

What’s Next

We’re already working on the next set of features based on your feedback. Stay tuned for updates on multi-channel support (SMS, WhatsApp) and advanced analytics.

Get Started

Ready to try Sunnybox 2.0?

• Sign up for an account
• Read the API documentation

Thank You

This release is the result of months of work and invaluable feedback from our users. Thank you for being part of the Sunnybox journey.

Questions or feedback? Email us at support@sunnybox.io.

Happy building!

A Month of Continuous Improvement

July started with our major API consolidation (v1.6.0), and we haven’t slowed down since. Here’s what we’ve delivered:

Unified Provider API (v1.6.0)

We kicked off the month by consolidating all provider operations under a single /api/v1/providers endpoint. This architectural improvement simplified email integration and introduced Gmail OAuth2 support. The new Base58 provider IDs also enhanced security while maintaining clean URLs.

Enhanced Email Sending (v1.7.0 - v1.7.2)

Mid-July brought significant improvements to our email sending capabilities:

• Full attachment support with base64 encoding
• Smart MIME type detection that works even when content types aren’t specified
• Intelligent input filtering that gracefully handles common edge cases
• Optional password fields for IMAP updates (no more re-entering passwords unnecessarily)

Background Job Tracking (v1.8.0)

We introduced the Jobs API, transforming email sending into an asynchronous operation with full visibility:

• Real-time status monitoring for all background operations
• Detailed error messages and retry tracking
• Standardized pagination across all list endpoints

Automatic Job Webhooks (v1.9.0 - v1.9.1)

Building on the Jobs API, we added automatic webhook notifications:

• Job completion and failure events sent to configured streams
• Provider-based routing ensures you only get relevant notifications
• Bug fixes for Thunderbird attachment display

Today’s Release (v1.9.2)

And we’re closing out July with:

• API autodiscovery for easier client integration
• Jobs dashboard in the admin UI for complete operational visibility
• Enhanced documentation with Restish CLI integration guide
• CASA certification achieved (Google LOV in progress)

The Bigger Picture

Looking at these releases together, a clear theme emerges: we’re making Sunnybox more robust, transparent, and developer-friendly. The Jobs API and dashboard give you unprecedented visibility into operations. The unified provider API and autodiscovery features reduce integration complexity. Smart input handling and validation make the API more forgiving and easier to work with.

What’s Coming Next

August will focus on leveraging our CASA certification and continuing to improve the developer experience:

Automated Gmail OAuth

Once Google processes our LOV, we’ll enable seamless Gmail authentication without manual token management.

Enhanced Analytics

Building on our Jobs infrastructure, we’re planning comprehensive email analytics to help you understand delivery patterns and optimize performance.

More CLI Tools

Following positive feedback on our Restish integration, we’re exploring official CLI tools and SDKs.

Performance Optimizations

With our monitoring infrastructure in place, we’re identifying and addressing performance bottlenecks across the platform.

Your Feedback Matters

This productive month wouldn’t have been possible without your feedback and feature requests. Many of July’s improvements came directly from user suggestions. Keep them coming!

Try It Out

All these features are available now. Check out our updated documentation to get started with the new APIs, or log into your dashboard to see the new Jobs view in action.

Here’s to an even more exciting August!

Happy coding!

What’s New?

Unified Provider Endpoint

Previously, managing email providers required navigating different endpoints for different provider types. With v1.6.0, all provider operations are now consolidated under a single, intuitive endpoint:

/api/v1/providers

This means whether you’re working with IMAP, Gmail, or future provider types, you’ll use the same consistent API surface.

Gmail OAuth2 Support

We’re introducing support for Gmail providers using OAuth2 authentication. While full automated OAuth flow is coming soon (pending CASA verification), you can already integrate Gmail accounts by providing your own OAuth tokens:

{
  "provider": {
    "providerType": "gmail",
    "email": "user@gmail.com",
    "accessToken": "ya29.a0AfH6SMBx...",
    "refreshToken": "1//0gYv8n7..."
  }
}

Simplified Configuration Model

We’ve eliminated the complexity of polymorphic relationships. Instead of tracking providableType and providableId, provider configurations are now embedded directly within the provider object:

Before (v1.5.0 and earlier):

{
  "name": "demo@example.com",
  "providableType": "ImapProvider",
  "providableId": 123
}

Now (v1.6.0):

{
  "name": "demo@example.com",
  "providerType": "imap",
  "config": {
    "type": "imap",
    "email": "demo@example.com",
    "host": "imap.example.com",
    "port": 993,
    // ... other IMAP-specific settings
  }
}

Enhanced Security with New ID Format

Provider IDs now use a URL-safe Base58 format (e.g., h8Kzj9Tx5mFqL3Nw7pRcVb2Y) instead of sequential integers. This improves security by making IDs non-guessable while maintaining compatibility with URL routing.

Improved Autoconfig

Creating IMAP providers is now even easier with enhanced autoconfig detection. For most popular email providers, you only need to provide an email and password:

{
  "provider": {
    "providerType": "imap",
    "email": "user@gmail.com",
    "password": "your-password"
  }
}

The API automatically detects the correct IMAP and SMTP settings for providers like Gmail, Outlook, Yahoo, and many others.

Migration Guide

Updating Your Integration

1. API Endpoints: Replace calls to /api/v1/imap_providers with /api/v1/providers

2. Request Format: Update your provider creation requests to use the new unified format:

   {
     "provider": {
       "providerType": "imap",
       "email": "user@example.com",
       "password": "password"
       // Optional: specify manual configuration
     }
   }
   

3. Response Handling: Provider configurations are now nested under the config field in responses

4. ID Format: Update any ID validation to accept the new Base58 string format

Breaking Changes

This is a breaking change. The old /api/v1/imap_providers endpoints have been removed completely. You must update your integration to use the new unified /api/v1/providers endpoint.

We understand breaking changes can be disruptive, but this consolidation significantly improves the API’s consistency and maintainability. The migration is straightforward, and the new structure sets us up for better extensibility going forward.

What’s Coming Next?

• Automated Gmail OAuth Flow: Once our CASA verification is complete, you’ll be able to authenticate Gmail accounts directly through Sunnybox without managing OAuth tokens yourself
• Additional Provider Types: The new architecture makes it easy for us to add support for more email providers
• Enhanced Provider Management: Bulk operations, provider templates, and more

Get Started

Check out our updated API documentation to explore the new unified provider API. The improved OpenAPI specification includes comprehensive examples for all provider types.

We’re confident this consolidation will make your email integration experience smoother and more maintainable. As always, we’d love to hear your feedback!

Happy coding!

What are Global Streams?

Global Streams are a new type of stream that automatically receives emails from all active providers in your account. Instead of manually configuring which providers send to which streams, you can now have a single stream that captures everything.

Key Benefits:

Automatic Provider Management

• No more manual configuration when adding or removing providers
• Providers are automatically added when activated
• Providers are automatically removed when deactivated
• Perfect for accounts that need centralized email processing

Consistent Behavior

• Every account now gets a global stream named “All Emails” upon creation
• The global stream cannot be deleted or renamed, ensuring consistency
• System-managed configuration prevents accidental misconfiguration

Seamless Integration

• Works with all existing webhook configurations
• Compatible with basic authentication and HTML body options
• Full API support for programmatic access

How It Works

When you create a new account, Sunnybox automatically creates a global stream for you. This stream:

1. Monitors all providers - Any active email provider in your account automatically sends emails to this stream
2. Updates dynamically - When you activate a new provider, it’s instantly added to the global stream
3. Maintains consistency - The stream’s name and description are fixed to prevent confusion

UI Enhancements

We’ve also improved the Streams interface to make global streams easy to identify and manage:

• Visual indicators - Global streams display a special “Global” badge with a helpful tooltip
• Smart ordering - Global streams always appear at the top of your streams list
• Protected fields - When editing a global stream, system-managed fields are disabled with explanatory messages
• Clear provider status - The edit interface shows which providers are active and included

API Updates

The Sunnybox API has been updated to version 1.4.2 with full support for global streams:

{
  "stream_type": "global",
  "name": "All Emails",
  "description": "Automatically receives emails from all active providers"
}

Global streams cannot be deleted via API, returning a 422 error with a clear message if attempted.

Migration for Existing Accounts

Don’t worry if you have existing accounts - we’ve got you covered! Our migration process will automatically create global streams for all existing accounts and connect their active providers.

What’s Next?

Global Streams are part of our ongoing effort to make email management more intelligent and automated. By reducing manual configuration, we’re freeing you up to focus on what matters: building great applications with email data.

This feature sets the stage for more intelligent email routing and processing features coming soon. Stay tuned!

Get Started

Global Streams are available now for all accounts. New accounts will automatically have them, and existing accounts will receive them through our migration process.

Questions or feedback? We’d love to hear from you!

Comprehensive Webhook Monitoring

Understanding how your webhooks perform is crucial for maintaining reliable email integrations. Our new webhook monitoring system provides complete visibility into every webhook call, helping you quickly identify and resolve any issues.

Key Features:

Detailed Event Tracking

• Full request and response payload visibility
• Response codes and timing information
• Success/failure status at a glance
• Filterable event history with date ranges

Enhanced Discoverability

• Clickable success rate indicators on the streams page
• Color-coded performance chips (green for >90%, yellow for 50-90%, red for <50%)
• Direct navigation to webhook logs from multiple entry points

Improved Event Details View

• Organized layout with clear status indicators
• One-click copying of webhook URLs and payloads
• Error details and debugging information when webhooks fail
• Request/response body inspection with proper formatting

Streamlined User Interface

We’ve redesigned the navigation flow to be more intuitive and efficient:

Unified Table-Based Layouts

• Consistent design across Streams, API Keys, and Webhook Events
• Powerful search functionality on every index page
• Clean, scannable tables with relevant information

Simplified Navigation

• Removed redundant stream detail pages
• Direct access to webhook events from the streams index
• Unified topbar for consistent navigation experience
• Collapsible filter sections to maximize screen real estate

Better Information Architecture

• Analytics icons clearly indicate clickable webhook statistics
• Proper header sections with contextual information
• Breadcrumb-style navigation for easy backtracking

Technical Improvements

Under the hood, we’ve made several technical enhancements:

• Removed unnecessary JSON/jbuilder support from UI controllers
• Replaced inline JavaScript with proper Stimulus controllers
• Improved controller efficiency by removing redundant code
• Enhanced test coverage for the new webhook monitoring features

What’s Next?

These improvements lay the groundwork for something even more exciting. We’re exploring ways to make Sunnybox smarter about understanding and processing your emails, going beyond simple forwarding to actually help you extract more value from your email data.

Stay tuned for announcements in the coming months – we think you’ll love what we’re building!

We’re committed to making Sunnybox the most reliable and user-friendly email API service available. These updates are just the beginning of our continuous improvement journey.

Try out the new webhook monitoring features today and let us know what you think!

🚀 Kamal Deployment: Simplified and Powerful

We’ve migrated our deployment infrastructure to Kamal, the modern deployment tool from 37signals. This change brings several benefits:

• Faster deployments - Direct container deployments without the complexity of Kubernetes
• Better reliability - Zero-downtime deployments with health checks
• Simplified operations - One tool to rule them all: kamal deploy

Behind the scenes, we’ve also upgraded to Ruby 3.4.4 and switched from GoodJob/Redis to Solid Queue/Solid Cache/Solid Cable - embracing the Rails 8 way of doing things with PostgreSQL-powered background jobs and caching.

📧 New Email API Features

HTML Body in Webhooks (v1.4.0)

Today’s release adds the most requested webhook feature: HTML email bodies!

Streams now have a showHtmlBody setting (enabled by default) that controls whether the sanitized HTML version of emails is included in webhook payloads. For your webhooks this means you can:

• Display rich email content in your applications
• Parse HTML structure for better content extraction
• Build more sophisticated email processing workflows

The feature is fully backwards compatible - existing streams automatically get HTML bodies in their webhooks.

Sent Folder Support (v1.3.2)

We now automatically save sent emails to your IMAP sent folder! This ensures emails sent via our API appear in your email client’s sent folder, maintaining a complete email history.

Smart defaults detect the right folder name:

• Gmail: “Sent Mail”
• Outlook: “Sent Items”
• Others: “Sent”

You can also specify a custom folder or disable this feature entirely with the new save_to_sent parameter.

Reply-To Headers (v1.3.1)

The API now supports Reply-To headers when sending emails. This allows you to:

• Set a different reply address than the sender
• Route responses to support queues
• Implement no-reply scenarios properly

🔒 Enhanced Security

We’ve implemented several security improvements across the platform to ensure your data remains safe and secure. Our commitment to security is ongoing, and we regularly review and update our practices.

📊 Webhook Monitoring

Stream webhooks now track success rates! You can monitor your webhook health directly in the dashboard, seeing response times and error rates for the last 7 days.

What’s Next?

We’re continuously working on improvements based on your feedback. Stay tuned for more enhancements to make your email integrations even more powerful!

Get Started

All these features are available now! Check out our updated API documentation for implementation details.

Questions or feedback? Reach out at bijan@screenisland.com.

Happy emailing! 📬

Cheers,
Bijan

What are Streams?

Streams are logical groupings of email providers that allow you to organize and route email messages efficiently. Whether you’re building a customer support system, managing multiple email accounts, or creating complex email workflows, streams provide the flexibility you need.

Key Features

Full CRUD Operations

The new API provides complete Create, Read, Update, and Delete operations for streams:

• GET /api/v1/streams - List all streams in your account
• GET /api/v1/streams/{id} - Get details for a specific stream
• POST /api/v1/streams - Create a new stream
• PATCH /api/v1/streams/{id} - Update an existing stream
• DELETE /api/v1/streams/{id} - Delete a stream

Webhook Integration

Each stream is configured with a webhook URL to receive real-time notifications when new messages arrive. We support secure HTTPS webhooks with optional Basic Authentication for added security.

Provider Association

Easily associate multiple email providers with a stream. This allows you to:

• Group related email accounts together
• Route messages from multiple sources to a single webhook
• Manage permissions and access at the stream level

Flexible Updates

Our PATCH endpoint supports partial updates, meaning you only need to send the fields you want to change. Want to update just the webhook URL? No problem:

{
  "stream": {
    "callbackUrl": "https://your-new-webhook.com/endpoint"
  }
}

Example Usage

Creating a new stream with providers:

curl -X POST https://api.sunnybox.io/api/v1/streams \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream": {
      "name": "Customer Support",
      "description": "All customer support email accounts",
      "callbackUrl": "https://myapp.com/webhooks/support",
      "basicAuth": true,
      "basicUser": "webhook_user",
      "basicPassword": "secure_password",
      "providerIds": [1, 2, 3]
    }
  }'

Developer-Friendly Features

JSON:API Format

All responses follow the JSON:API specification, providing a consistent and predictable structure with proper error handling and relationship management.

OpenAPI Documentation

Our API is fully documented with OpenAPI 3.1 specification. Use your favorite API client or code generator to integrate quickly.

What’s Next?

This is just the beginning! We’re planning to add more features to streams, including:

• Message filtering rules
• Advanced routing options
• Stream-level analytics
• Rate limiting controls

Get Started Today

The Streams API is available now for all SunnyboxAI users. Check out our API documentation for complete details and start building amazing email integrations today!

Have questions or feedback? We’d love to hear from you at bijan@screenisland.com

Happy streaming! 🚀

Cheers Bijan

What’s New?

We’ve completely revamped our backend infrastructure with state-of-the-art technology:

• Server Architecture Upgrade: We’ve migrated to a modern, non-blocking server architecture that makes efficient use of all available CPU cores. This means SunnyBox can now handle many more concurrent connections without slowing down.

• Enhanced Email Processing: Many of you use SunnyBox to interact with email services. We’ve optimized these connections to prevent bottlenecks during peak usage times.

• Improved Security Measures: We’ve implemented additional protection layers against distributed denial-of-service (DDoS) attacks, ensuring SunnyBox remains available even when under pressure.

What This Means For You

These improvements translate to real benefits for our users:

• Faster Response Times: Pages load quicker and operations complete more rapidly
• Higher Reliability: The service remains responsive even during high-traffic periods
• Better Scalability: We can now accommodate growth more efficiently

Looking Ahead

This infrastructure upgrade lays the foundation for several exciting new features we’re planning to roll out in the coming weeks. We’re committed to continuously improving SunnyBox and delivering the best possible experience to our users.

Stay tuned for more updates!

Do you have questions about these improvements? Feel free to reach out to our support team.

Besides that Sunnybox received a few quality of life changes and more polish. Stay tuned for more.