​

Common Issues and Solutions

This troubleshooting guide helps you resolve common issues you might encounter while using the TikFlow.

​

Upload Issues

​

Video Upload Failed

Symptoms: Upload gets stuck, fails with error, or shows “processing failed” Solutions:

1. Check file format: Ensure your video is in MP4 format with H.264 codec
2. Verify file size: Videos must be under 1GB
3. Check internet connection: Unstable connections can cause upload failures
4. Try direct upload: If URL upload fails, download the video and upload directly
5. Clear browser cache: Sometimes cached data can interfere with uploads

​

Photo Carousel Quality Issues

Symptoms: Photos appear blurry, pixelated, or cropped incorrectly Solutions:

1. Use proper resolution: Photos should be at least 1080x1920 pixels
2. Check file format: Use JPG or PNG format only
3. Verify file size: Each photo must be under 10MB
4. Maintain aspect ratio: Use 9:16 aspect ratio for best results

​

Upload Limit Reached

Symptoms: “Upload limit exceeded” error message Solutions:

1. Check current usage: View your usage in the Subscription dashboard
2. Wait for reset: Upload limits reset on your subscription anniversary date
3. Upgrade plan: Consider upgrading to a higher plan for more uploads
4. Delete unused uploads: Remove failed or unnecessary uploads to free up space

​

Scheduling Issues

​

Scheduled Post Failed to Publish

Symptoms: Scheduled post shows “failed” status or doesn’t publish at scheduled time Solutions:

1. Check TikTok connection: Ensure your TikTok account is still connected and authorized
2. Verify publish time: Make sure the scheduled time is in the future (UTC timezone)
3. Check video status: Ensure the video upload completed successfully
4. Review TikTok permissions: Reconnect your TikTok account if permissions were revoked

​

Incorrect Publish Time

Symptoms: Post publishes at wrong time Solutions:

1. Use UTC timezone: All scheduled times must be in UTC (ISO 8601 format)
2. Convert your local time: Use online UTC converters to ensure correct timing
3. Add buffer time: Schedule at least 15 minutes ahead to account for processing

​

Scheduling Feature Unavailable

Symptoms: Scheduling options not visible or accessible Solutions:

1. Check subscription plan: Scheduling is only available on Basic, Professional, and Professional plans
2. Upgrade plan: Upgrade to access scheduling features
3. Contact support: If you believe you should have access, contact support

​

Analytics Issues

​

Missing Analytics Data

Symptoms: No data showing in analytics dashboard or API returns empty results Solutions:

1. Wait 24-48 hours: Analytics data takes time to populate after video publication
2. Check video status: Ensure videos were published successfully through our platform
3. Verify subscription: Analytics is only available on Basic, Professional, and Professional plans
4. Check TikTok account: Ensure your TikTok account has analytics enabled (Business/Creator account required)

​

Inconsistent Metrics

Symptoms: Analytics numbers don’t match TikTok’s native analytics Solutions:

1. Platform difference: Our analytics only tracks content published through our platform
2. Data sync delay: Allow 24 hours for data to fully sync
3. API limitations: Some metrics may have slight variations due to TikTok API limitations

​

API Issues

​

Authentication Errors

Symptoms: 401 Unauthorized or 403 Forbidden errors Solutions:

1. Check token validity: Ensure your JWT token or API key hasn’t expired
2. Verify token format: Use proper Bearer token format in Authorization header
3. Regenerate API key: If using API key, try generating a new one
4. Check permissions: Ensure your subscription plan includes the requested feature

​

Rate Limit Exceeded

Symptoms: 429 Too Many Requests errors Solutions:

1. Check rate limits: Review your plan’s rate limits in the documentation
2. Implement backoff: Add exponential backoff to your API calls
3. Cache responses: Cache API responses to reduce unnecessary calls
4. Upgrade plan: Consider upgrading for higher rate limits

​

Invalid Request Parameters

Symptoms: 400 Validation Error with detailed error messages Solutions:

1. Review parameter requirements: Check the API documentation for required fields and formats
2. Validate data types: Ensure you’re sending correct data types (strings, numbers, booleans)
3. Check character limits: Verify text fields don’t exceed maximum lengths
4. Use proper datetime format: All datetime fields must be ISO 8601 format in UTC

​

AI Feature Issues

​

AI Features Not Working

Symptoms: AI chat or script generation fails or returns errors Solutions:

1. Check AI API key: Ensure you have a valid Google Gemini API key configured
2. Verify subscription: AI features require Basic, Professional, or Professional plan
3. Check AI usage limits: Ensure you haven’t exceeded your monthly AI request limit
4. Review AI provider status: Check Google Gemini status page for service issues

​

Poor AI Output Quality

Symptoms: AI-generated content is generic, irrelevant, or low quality Solutions:

1. Provide detailed prompts: Include specific context, audience, and requirements
2. Iterate and refine: Try different prompt variations for better results
3. Add constraints: Specify tone, length, and content requirements clearly
4. Review and edit: Always review and personalize AI-generated content before publishing

​

Account and Connection Issues

​

TikTok Account Connection Failed

Symptoms: Unable to connect TikTok account or connection keeps dropping Solutions:

1. Check TikTok account type: Must be Business or Creator account
2. Verify permissions: Ensure you’re granting all required permissions during OAuth
3. Clear TikTok cookies: Clear browser cookies for TikTok.com
4. Try different browser: Some browser extensions can interfere with OAuth

​

Session Timeout

Symptoms: Getting logged out frequently or session expires quickly Solutions:

1. Check browser settings: Ensure cookies are enabled for our domain
2. Clear conflicting cookies: Remove old or conflicting session cookies
3. Disable privacy extensions: Some browser privacy extensions block session cookies
4. Use incognito mode: Test in incognito/private browsing mode to isolate issues

​

Performance Issues

​

Slow Dashboard Loading

Symptoms: Dashboard takes too long to load or respond Solutions:

1. Check internet connection: Ensure you have a stable, high-speed connection
2. Clear browser cache: Old cached data can cause performance issues
3. Disable browser extensions: Some extensions can slow down web applications
4. Try different browser: Test in a different browser to isolate the issue

​

API Response Delays

Symptoms: API calls taking longer than expected Solutions:

1. Check network latency: Test your connection to our API endpoint
2. Monitor rate limits: High usage near rate limits can cause delays
3. Optimize requests: Combine multiple requests where possible
4. Contact support: If delays persist, contact support with request IDs

​

Contact Support

If you can’t resolve your issue using this guide, contact our support team:

• Email: [email protected]
• Response Time: Within 24 hours for Basic plans, within 4 hours for Professional/Professional plans
• Include: Your account email, detailed description of the issue, screenshots, and any error messages