Social Posts
Connect your social media accounts to publish content directly from Cuppa. Auto-generate platform-optimized posts when articles go live.
Supported Platforms
| Platform | Posting | Scheduling | Images | Carousels |
|---|---|---|---|---|
| X (Twitter) | ✅ | ✅ | ✅ | ❌ |
| ✅ | ✅ | ✅ | ✅ | |
| ✅ | ✅ | ✅ | ✅ | |
| ✅ | ✅ | ✅ | ✅ | |
| Threads | ✅ | ✅ | ✅ | ❌ |
| TikTok | ✅ | ✅ | ✅ | ❌ |
| ✅ | ✅ | ✅ | ❌ | |
| YouTube | ✅ (video) | ✅ | ✅ | ❌ |
| Bluesky | ✅ | ✅ | ✅ | ❌ |
| Drafts only | ❌ | ❌ | ❌ |
Connection limits and billing
Each connected social account (one platform handle, e.g. one Instagram or one LinkedIn page) counts as one connection. How connections are billed depends on your plan type.
Lifetime plans
Your license includes a set number of social connections. Connect more any time: each connection above your included count is billed from your Cuppa Gateway wallet, prorated daily.
| Lifetime tier | Included connections | Extra connections |
|---|---|---|
| Starter | 1 | from $7.20/mo each |
| Solo | 2 | from $7.20/mo each |
| Studio | 3 | from $7.20/mo each |
| Scale | 5 | from $3.60/mo each |
| Enterprise | 10 | from $3.60/mo each |
If your wallet runs out, connections above your included count pause after a short grace period (your data is kept, reconnect is instant once you top up). Turn on wallet auto-reload to avoid interruptions.
Monthly and annual plans
Your plan includes a fixed number of connections (a hard cap). To connect more, upgrade your plan.
| Plan | Included connections |
|---|---|
| Solo (Power) | 3 |
| Studio (Business) | 9 |
| Scale (Agency) | 25 |
| Enterprise (Agency+) | 50 |
X (Twitter) API usage
X charges per API call for inbox and analytics sync. This is off by default. To enable it, opt in per brand in Site Settings and set a monthly spend cap. Usage is metered to your Gateway wallet (lifetime) and sync pauses automatically when you hit the cap or run out of balance. Cuppa never bills you for X usage you did not opt into.
Platform Format Matrix
| Platform | Text | Image | Video | Carousel | Char Limit | Notes |
|---|---|---|---|---|---|---|
| Twitter/X | Yes | Optional | No | No | 280 | Punchy, concise |
| Yes | Optional | Optional | Yes | 3,000 | Professional depth | |
| Yes | Required | Reels | Yes | 2,200 | Always include visual | |
| Yes | Optional | Optional | No | 63,206 | Longer format OK | |
| TikTok | Yes | No | Required | No | 2,200 | Video-only platform |
| Yes | Required | No | No | 500 | Keyword-rich pins | |
| Threads | Yes | Optional | No | No | 500 | Conversation starters |
| Bluesky | Yes | Optional | No | No | 300 | Short and direct |
| Yes | Optional | No | No | 40,000 | Value-first, no promotion | |
| YouTube | Yes | No | Required | No | 5,000 | Videos and Shorts via Video Gallery (connect in Site Settings) |
| Telegram | Yes | Optional | No | No | 4,096 | Channel-style messages |
| Google Business | Yes | Optional | No | No | 1,500 | Local business updates |
Content Format Decision Tree
- Text only? Works on: Twitter, LinkedIn, Facebook, Threads, Bluesky, Reddit, Telegram, Google Business
- Need video? Use: TikTok, YouTube (connect account + publish from Video Gallery), Instagram Reels, LinkedIn, Facebook
- Carousel? Use: LinkedIn, Instagram
- Image required? Instagram and Pinterest always need an image. TikTok and YouTube always need video.
CLI Format Guidance
The CLI warns you when format and platform don’t match:
# This will show a warning:
cuppa social multi --platforms tiktok --article-title "Tips" --article-summary "..."
# ⚠ tiktok performs best with video content. Consider using 'cuppa video create' for tiktok.
# For TikTok, use the video workflow:
cuppa video script --brief "Pet grooming tips" --video-format tutorial_howto --platform tiktok
cuppa video create --prompt "..." --model replicate:runway-gen-4.5 --aspect-ratio 9:16
cuppa social share-video --video-id <id> --platform tiktok --content "Check this out!"Connecting Your Accounts
Step 1: Navigate to Integrations
- Go to Site Settings → Integrations
- Find Social Connections section
Step 2: Connect a Platform
- Click Connect on your platform
- Sign in with your social account
- Authorize Cuppa to post on your behalf
- For LinkedIn/Facebook: Select the page or profile to connect
Step 3: Verify Connection
Once connected, you’ll see:
- Account name and profile picture
- Connection status (✅ Connected)
- Option to disconnect
Platform-Specific Setup
X (Twitter)
- Click Connect on X/Twitter
- Authorize the app
- Your personal account or connected account is ready
LinkedIn can connect to:
- Personal profile - Post as yourself
- Company page - Post as your business
- Click Connect on LinkedIn
- Sign in to LinkedIn
- Select organization if posting to a company page
- Authorize Cuppa
Instagram connects via Facebook Business:
- Ensure your Instagram is a Business or Creator account
- Link Instagram to a Facebook Page
- Click Connect on Instagram in Cuppa
- Authorize via Facebook
- Select your Instagram account
- Click Connect on Facebook
- Select the Page you want to post to
- Authorize Cuppa
Reddit works differently - we generate drafts only:
- Enable Reddit in Content Strategy → Social Settings
- No OAuth connection needed
- Drafts appear in your Reddit Drafts section
- Copy and post manually to your preferred subreddits
Why drafts only? Reddit bans accounts that appear promotional. Manual posting lets you customize for each subreddit and protect your reputation.
Auto-Posting Setup
Enable Social Automation
- Go to Content Strategy → Social Settings
- Toggle “Auto-generate social posts from articles”
- Select default platforms
- Configure settings:
| Setting | Description |
|---|---|
| Default platforms | Which platforms get posts |
| Tone | Professional, casual, playful, etc. |
| Include CTA | Add call-to-action |
| Include hashtags | Note: Outdated on X/LinkedIn |
| Image model | Nano Banana Pro recommended |
How It Works
- You publish an article
- Cuppa generates platform-optimized posts
- AI creates matching images (if enabled)
- Posts go to your queue for review
- Approve to publish, or edit first
Troubleshooting
”Connection failed”
- Try disconnecting and reconnecting
- Ensure you have admin access (for pages)
- Check the platform isn’t experiencing outages
”Post failed to publish”
- Verify account is still connected
- Check for platform-specific restrictions
- Ensure image meets platform requirements
”LinkedIn organization not found”
- You need admin access to the company page
- Try reconnecting and selecting the organization
”Instagram connection issues”
- Instagram must be a Business/Creator account
- Must be linked to a Facebook Page
- Reconnect via Facebook integration
FAQ
Can I schedule posts for later?
Yes! Select a date/time when publishing instead of “Post Now.”
Can I post to multiple platforms at once?
Yes. Select multiple platforms and Cuppa generates optimized content for each.
Do I need separate accounts for each brand?
Each Cuppa site can connect to one set of social accounts. For multiple brands, create separate sites.
Can I edit posts before they go live?
Yes. Auto-generated posts go to a queue. Review and edit before approving.
What about LinkedIn articles vs posts?
Currently, Cuppa creates LinkedIn posts. LinkedIn articles (newsletters) are in development.
Why can’t I auto-post to Reddit?
Reddit heavily penalizes promotional content. We generate drafts so you can customize for each subreddit and maintain authenticity.
API & Agent Access
All social features are available programmatically via the REST API, MCP server, and CLI.
Post Management
| Endpoint | MCP Tool | Description |
|---|---|---|
GET /v1/social/posts | list_social_posts | List posts with analytics |
POST /v1/social/publish | publish_social | Publish a new post immediately |
POST /v1/social/schedule | schedule_social | Schedule a new post for later |
GET /v1/social/analytics | get_social_analytics | Live analytics, followers, best times, top posts |
Draft Post Scheduling
Draft social posts created by the content planner can be scheduled or published without re-creating them:
| Endpoint | MCP Tool | CLI Command | Description |
|---|---|---|---|
POST /v1/social/posts/:id/schedule | schedule_social_draft | cuppa social posts schedule-draft | Schedule a single draft |
POST /v1/social/posts/:id/publish | publish_social_draft | cuppa social posts publish-draft | Publish a single draft immediately |
POST /v1/social/posts/bulk-schedule | bulk_schedule_social_drafts | cuppa social posts schedule-drafts | Bulk schedule/publish up to 50 posts |
See Agent Brand Engineering for full workflow examples.