Social Generation
Social Media Integrations
Connect your social media accounts to publish content directly from Cuppa. Auto-generate platform-optimized posts when articles go live.
Supported Platforms
X (Twitter)
✅
✅
✅
❌
✅
✅
✅
✅
✅
✅
✅
✅
✅
✅
✅
✅
Threads
✅
✅
✅
❌
TikTok
✅
✅
✅
❌
✅
✅
✅
❌
YouTube
✅
✅
✅
❌
Bluesky
✅
✅
✅
❌
Drafts only
❌
❌
❌
Platform Format Matrix
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
Community posts or Shorts
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, 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:
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
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
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
Facebook
Click Connect on Facebook
Select the Page you want to post to
Authorize Cuppa
Reddit
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:
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
Creating Social Posts
From an Article
Open any article
Click Generate Social Posts
Select platforms
Review and edit generated content
Schedule or publish
Standalone Posts
Go to Create Content → Social
Enter your topic or content
Select platforms
Generate and publish
LinkedIn Carousels
Create multi-slide lead magnets:
Go to Create Content → LinkedIn Carousel
Enter your topic
Configure slides (5-10 recommended)
Generate carousel
Each slide gets AI-generated visuals
Publish directly to LinkedIn
Image Generation
Default Model
Nano Banana Pro 🍌 is the default for social images:
High quality, fast generation
Optimized for social dimensions
~$0.15 per image
Platform Dimensions
X/Twitter
16:9
Feed posts
1.91:1
Feed posts
1:1 or 4:5
Feed posts
1.91:1
Feed posts
2:3
Pins
Cuppa automatically generates images in the right dimensions for each platform.
Best Practices
Platform Voice
Each platform has different expectations:
X
Punchy, conversational, thread-friendly
Professional, thought leadership
Visual-first, lifestyle
Community-focused, shareable
Value-first, not promotional
Posting Frequency
Don't over-post. Recommended maximums:
X
3-5 per day
1-2 per day
1-2 per day
1-2 per day
Hashtag Strategy
Modern best practices:
X/Twitter — Hashtags reduce engagement. Skip them.
LinkedIn — Hashtags are outdated. Skip them.
Instagram — 3-5 relevant hashtags still work
TikTok — 3-5 trending hashtags
Cuppa follows these guidelines by default.
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.
Social Analytics
Returns impressions, engagements, clicks, per-platform breakdown, and top posts.
MCP tool: get_social_analytics
Standalone Social Generation
Generate posts from any topic without needing an article:
MCP tools: generate_social, generate_social_multi
Post Management
GET /v1/social/posts
list_social_posts
List posts with analytics
POST /v1/social/publish
publish_social
Publish immediately
POST /v1/social/schedule
schedule_social
Schedule for later
GET /v1/social/analytics
get_social_analytics
Performance metrics
See Agent Brand Engineering for full workflow examples.
Related Docs
Content Planner — Social automation settings
Doc paths: Planner content also exists at
/learn/automations/content-planner(legacy URL with an extra “s”). Both pages are kept so old links keep working; prefer/learn/automation/content-plannerfor new links.
Agent Brand Engineering — AI agent workflows
Replicate API — Image generation setup
LinkedIn Carousels — Multi-slide content
Last updated
Was this helpful?