Troubleshooting

Common issues and their solutions.

Authentication Issues

Invalid API Key

Error: 401 Unauthorized

Solution:

1. Verify your API key in Settings → API Keys
2. Ensure the API key is correctly set in your request headers
3. Check that the API key hasn't been revoked

Missing API Key

Error: 401 Unauthorized with message "API key required"

Solution:

• Include the X-API-Key header in all requests
• For SDK users, ensure client.setConfig() is called with your API key

Rate Limit Issues

Rate Limit Exceeded

Error: 429 Too Many Requests

Solution:

• Implement exponential backoff
• Use bulk endpoints when possible
• Monitor rate limit headers
• Consider upgrading to Enterprise tier for higher limits

Media Upload Issues

Upload Failed

Error: Upload fails during file upload

Solution:

1. Verify file size is within platform limits
2. Check file format is supported
3. Ensure presigned URL hasn't expired (1 hour TTL)
4. Verify network connection is stable

Aspect Ratio Errors

Error: Media doesn't meet platform aspect ratio requirements

Solution:

• Use the image cropping tool in the dashboard
• Check platform-specific aspect ratio requirements
• Use media validation before uploading

Post Publishing Issues

Post Failed to Publish

Error: Post fails to publish to platform

Common Causes:

• Channel disconnected or token expired
• Platform-specific content violations
• Rate limits on platform side
• Network issues

Solution:

1. Check channel connection status
2. Review platform-specific requirements
3. Retry the publish operation
4. Check platform status page for outages

SDK Issues

Type Errors

Error: TypeScript compilation errors

Solution:

• Ensure you're using TypeScript 5.0+
• Update to latest SDK version: npm install fanbeam@latest
• Check that types are imported correctly

Import Errors

Error: Module not found

Solution:

• Verify SDK is installed: npm list fanbeam
• Check Node.js version (18+ required)
• Clear node_modules and reinstall

Getting Help

If you're still experiencing issues:

1. Check the API Documentation
2. Review SDK Documentation
3. Contact support at support@fanbeam.app

Next Steps

• Platform Limits
• API Reference