Introduction

What is Boring?

Boring is a cloud-based social media token manager and publishing API that simplifies content distribution across multiple platforms. With Boring, you can manage Facebook Pages, Instagram Business accounts, Threads accounts, TikTok accounts, and YouTube channels from a single unified API.

Key Features

🔐 Secure Token Management

• Long-lived tokens that automatically refresh
• Facebook Page tokens never expire
• Instagram tokens valid for 60 days with auto-conversion
• Threads tokens valid for 60 days with auto-refresh (5 days before expiry)

📱 Multi-Platform Publishing

Publish various content types across platforms:

Facebook

• Text-only posts
• Single photo posts
• Photo albums (2-10 images)
• Video posts

Instagram

• Single photo posts
• Carousel posts (2-10 images)
• Reels (video content)

Threads

• Text-only posts
• Single photo posts
• Carousel posts (2-20 images)
• Video posts
• Long-form threads (multi-post threads)

TikTok

• Video uploads (up to 4GB, 10 minutes max)
• Captions with hashtags (max 2200 characters)
• Chunked upload for large files

YouTube

• Video uploads with metadata
• Custom thumbnails
• Tags and descriptions
• Privacy settings

🔑 Simple API Authentication

• Google OAuth for dashboard access
• API key-based authentication for programmatic access
• JWT-based persistent sessions

📊 Publishing History

• Track all published content
• Success/failure status
• Detailed error messages
• Last 20 posts visible on dashboard

⚡ Developer Friendly

• RESTful API design
• JSON request/response format
• Comprehensive error handling
• Clear documentation and examples

How It Works

1. Connect Your Accounts

Sign in to the Boring Dashboard using your Google account, then connect your social media accounts:

• Facebook Pages via Facebook OAuth
• Instagram Business accounts via Instagram OAuth
• Threads accounts via Threads OAuth
• TikTok accounts via TikTok OAuth
• YouTube channels via Google OAuth

2. Generate API Keys

Navigate to the Settings page and generate one or more API keys. Each key is prefixed with boring_ and can be named for easy identification.

3. Publish Content

Use the /v2/posts API endpoint to publish content. Simply provide:

• Your API key in the request header
• Account ID (obtained from dashboard)
• Content (text and/or media URLs)
• Platform type

4. Monitor Results

View your publishing history on the dashboard or retrieve it via API to track success rates and troubleshoot any issues.

Architecture

Boring is built on Google Cloud Platform (GCP) with:

• Cloud Functions (Gen 2) for serverless API hosting
• MongoDB for data persistence
• OAuth 2.0 for secure authentication
• JWT tokens for session management

Use Cases

Boring is perfect for:

• Social Media Agencies - Manage multiple client accounts from one platform
• Content Creators - Cross-post content to multiple platforms simultaneously
• Marketing Teams - Automate social media publishing workflows
• SaaS Applications - Integrate social publishing into your product
• Automation Tools - Build bots and schedulers for social content

Next Steps

Ready to get started? Continue to:

• Authentication - Learn how to sign in and authenticate
• API Keys - Generate your first API key
• API Reference - Explore the API endpoints