Supported Platforms
TikTok
Short-form vertical videos optimized for mobile viewing
Stories, Reels, and feed posts with aspect ratio optimization
YouTube
Long-form content and YouTube Shorts
X (Twitter)
Video tweets with automatic compression and formatting
Managing Connections
All social platform connections are managed through the Connections page in your ClypAI dashboard at/connections.
Adding a New Connection
Select Platform
Choose the social platform you want to connect from the available options:
- TikTok
- Instagram Business
- YouTube
- X/Twitter
Authorize Access
You’ll be redirected to the platform’s authorization page. Grant the necessary permissions for ClypAI to publish on your behalf.
Each platform may require different permission scopes. ClypAI only requests the minimum permissions necessary to publish content.
Platform-Specific Details
TikTok
Connection Requirements:- TikTok account in good standing
- Access to TikTok’s Content Posting API
- Post vertical videos (9:16 aspect ratio)
- Add captions and hashtags
- Schedule posts for later
- Format: MP4
- Resolution: 1080x1920 recommended
- Duration: 3 seconds to 10 minutes
- File size: Up to 287.6 MB
- Instagram Business or Creator account
- Connected to a Facebook Page
- Reels: 9:16 vertical videos, 3-90 seconds
- Stories: 9:16 vertical videos, up to 60 seconds
- Feed Posts: Square (1:1) or vertical (4:5) videos
- Format: MP4 or MOV
- Codec: H.264
- Frame rate: 30 FPS recommended
- Maximum file size: 100 MB for Reels, 4 GB for feed posts
YouTube
Connection Requirements:- YouTube channel with upload permissions
- Google account with YouTube Data API access
- Shorts: Vertical videos under 60 seconds
- Regular Videos: Any length and aspect ratio
- Format: MP4, MOV, AVI, WMV, FLV, 3GPP, WebM, DNxHR, ProRes, CineForm, HEVC (h265)
- Resolution: Up to 4K (3840x2160)
- Frame rate: 24, 25, 30, 48, 50, or 60 FPS
- Maximum file size: 256 GB
- Title (max 100 characters)
- Description (max 5,000 characters)
- Tags
- Category
- Privacy settings (public, unlisted, private)
X (Twitter)
Connection Requirements:- X account with video upload permissions
- X API access (provided through ClypAI integration)
- Post videos up to 2 minutes and 20 seconds
- Add tweet text and mentions
- Include multiple videos in threads
- Format: MP4 or MOV
- Resolution: 1920x1200 or 1200x1900 recommended
- Aspect ratio: 1:2.39 to 2.39:1
- Frame rate: 40 FPS max
- Maximum file size: 512 MB
X Premium subscribers can upload longer videos (up to 3 hours). Standard accounts are limited to 2 minutes and 20 seconds.
Connection Status & Management
Each connected account displays the following information:- Username: The connected account’s username
- Platform: The social media platform
- Status: Active or disconnected
- Connected Date: When the connection was first established
- Last Updated: When the connection was last refreshed
Refreshing Connections
Access tokens may expire over time. If a connection shows as disconnected:- Click on the connection in your Connections list
- Select “Refresh Connection”
- Re-authorize access if prompted
Removing Connections
To remove a social platform connection:- Navigate to the Connections page
- Click on the connection you want to remove
- Select “Remove Connection”
- Confirm the removal
Publishing Workflow
Once platforms are connected, publishing is streamlined:Select Platforms
Choose which connected platforms to publish to. You can publish to multiple platforms simultaneously.
Customize Per Platform
Adjust captions, hashtags, and metadata for each platform. ClypAI automatically optimizes video format and aspect ratio.
Best Practices
Aspect Ratios
Aspect Ratios
- TikTok: Always use 9:16 vertical
- Instagram Reels: 9:16 vertical
- Instagram Feed: 1:1 square or 4:5 vertical
- YouTube Shorts: 9:16 vertical
- YouTube Videos: 16:9 horizontal
- X (Twitter): 16:9 horizontal or 9:16 vertical
Captions & Hashtags
Captions & Hashtags
Posting Times
Posting Times
Schedule posts during peak engagement times for each platform:
- TikTok: 6 PM - 10 PM local time
- Instagram: 11 AM - 1 PM, 7 PM - 9 PM
- YouTube: 2 PM - 4 PM on weekdays
- X: 8 AM - 10 AM, 12 PM - 1 PM, 5 PM - 6 PM
Content Guidelines
Content Guidelines
Always follow each platform’s community guidelines:
- Avoid copyrighted content without permission
- Respect trademark and intellectual property rights
- Follow content policies regarding violence, adult content, and misinformation
- Include appropriate content warnings when necessary
Troubleshooting
Connection Failed
Issue: Unable to connect a social platform account Solutions:- Ensure your account meets the platform’s requirements (e.g., Instagram Business account)
- Check that you granted all requested permissions
- Verify your account is in good standing with the platform
- Try disconnecting and reconnecting the account
Upload Failed
Issue: Video upload to platform failed Solutions:- Check video meets platform specifications (file size, duration, format)
- Verify your connection is still active
- Ensure your account has upload permissions
- Check platform status for any outages
Token Expired
Issue: “Token expired” or “Authentication failed” error Solutions:- Refresh the connection from the Connections page
- Re-authorize access to the platform
- Check if you revoked ClypAI’s access in the platform’s settings
API Rate Limits
Each platform has API rate limits that may affect publishing:| Platform | Rate Limit | Notes |
|---|---|---|
| TikTok | Varies by account | Higher limits for verified accounts |
| 25 posts per day | Per connected account | |
| YouTube | 10,000 quota units/day | Uploads cost 1,600 units each |
| X (Twitter) | 300 tweets per 3 hours | Includes video posts |
ClypAI automatically handles rate limiting and will queue posts if limits are reached.
Next Steps
Configure Storage
Learn how to set up Supabase storage for your video files