Social Media Integrations
Transform your AI Social Manager into a fully automated posting system by connecting your social media accounts. Once configured, your scheduled posts will automatically publish to Facebook, Instagram, TikTok, and Twitter/X without any manual intervention.
Supported Platforms
✓ Meta (Facebook + Instagram)
- Automatic image posting
- Caption with hashtags
- Page and Instagram Business Account support
✓ TikTok
- Automatic video posting
- Privacy level controls
- Caption support
✓ Twitter/X
- Tweet posting with images
- Up to 4 images per tweet
- 280-character handling
Getting Started
#### Step 1: Navigate to Integrations
Go to Admin > Integrations and scroll to the Social Media section.
#### Step 2: Choose Your Platform
For Facebook & Instagram (Meta):
1. Click "Connect Meta"
2. You'll need:
- Meta App ID
- Meta App Secret
- (Get these from https://developers.facebook.com/)
3. Click "Authorize" and log in with your Facebook account
4. Grant permissions:
- `pages_manage_posts`
- `pages_read_engagement`
- `instagram_basic`
- `instagram_content_publish`
5. Select your Facebook Page and Instagram Business Account
For TikTok:
1. Click "Connect TikTok"
2. You'll need:
- TikTok Client Key
- TikTok Client Secret
- (Get these from https://developers.tiktok.com/)
3. Click "Authorize" and log in
4. Grant Content Posting API permissions
5. Your TikTok account will be linked
For Twitter/X:
1. Click "Connect Twitter"
2. You'll need:
- Twitter Client ID
- Twitter Client Secret
- (Get these from https://developer.twitter.com/)
3. Click "Authorize"
4. Grant permissions for tweet creation
5. Your Twitter account will be connected
Creating Developer Apps
Meta (Facebook/Instagram):
1. Visit https://developers.facebook.com/
2. Click "My Apps" > "Create App"
3. Choose "Business" type
4. Add Products: "Facebook Login" and "Instagram Basic Display"
5. In Settings > Basic, copy your App ID and App Secret
6. Add your redirect URI: `https://tablecore.app/api/integrations/meta/callback`
TikTok:
1. Visit https://developers.tiktok.com/
2. Create a new app
3. Enable "Content Posting API" product
4. Copy Client Key and Client Secret
5. Set redirect URI: `https://tablecore.app/api/integrations/tiktok/callback`
Twitter / X:
1. Visit https://developer.twitter.com/
2. Create a project and app
3. Enable OAuth 2.0 in User Authentication Settings
4. Set Type: "Web App"
5. Add Redirect URI: `https://tablecore.app/api/integrations/twitter/callback`
6. Copy Client ID and Client Secret
How Auto - Publishing Works
Once connected, the system runs automatically:
1. You create content in the AI Social Manager
2. AI generates post visuals and captions
3. You schedule posts using "Auto-Schedule Week" or manually
4. Cron job runs every 15 minutes , checking for scheduled posts
5. Posts are published automatically at their scheduled time
6. Status updates to "Posted" with a link to the live post
Platform - Specific Requirements
Instagram:
- Requires a public image URL (HTTPS)
- Must be an Instagram Business Account (not personal)
- Supports 4: 5(portrait), 1: 1(square), 1.91: 1(landscape)
- Max 8MB image size
Facebook:
- Can post text - only or with images
- Recommended: Always include an image for better engagement
TikTok:
- Requires video files (not static images)
- Formats: MP4, MOV, WEBM
- Duration: 3 seconds to 10 minutes
- Max 200MB file size
Twitter / X:
- 280 - character limit for text
- Up to 4 images per tweet
- Max 5MB per image
Troubleshooting
"Token Expired" Error:
- Meta tokens last 60 days
- Simply reconnect the integration in Admin > Integrations
"Permission Denied" Error:
- Ensure you granted all required permissions during OAuth
- Try disconnecting and reconnecting with full permissions
Posts Not Publishing:
1. Check integration status: Admin > Integrations
2. Verify the post is marked "Scheduled"(not "Draft")
3. Check the scheduled time has passed
4. View logs in the Publishing Manager
Image Not Showing:
- Ensure the image URL is publicly accessible(HTTPS)
- Images must be hosted on Supabase Storage or external CDN
- Check file size limits for each platform
Best Practices
Timing:
- Use "Auto-Schedule Week" for optimal posting times
- Default times: 10am, 2pm, 6pm, 9pm
- Posts publish within 15 minutes of scheduled time
Content:
- Instagram: High - quality images, engaging captions
- Facebook: Longer captions with storytelling
- TikTok: Short, punchy videos with trending sounds
- Twitter: Concise, witty text with relevant hashtags
Monitoring:
- Check Publishing Manager daily
- Review post performance on native platforms
- Adjust brand kit based on what performs best
Security & Privacy
- All tokens are encrypted using AES - 256 - GCM
- Tokens stored in secure database with RLS policies
- Only org admins can manage integrations
- Cron endpoint protected by secret key
- OAuth flows use industry - standard PKCE security
Need Help ?
If you encounter issues:
1. Check the full[Auto - Publish Guide](/docs/AUTO_PUBLISH_GUIDE.md)
2. Contact support with your error message
3. Include screenshot of integration status page