Documentation Index
Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt
Use this file to discover all available pages before exploring further.
Due to API limitations, Facebook Profiles are not supported. Facebook Pages (and some Groups) are supported.
Available capabilities
| Publish | Analytics | Engage |
|---|
| ✓ | ✓ | ✓ |
Capabilities in Facebook via Aitoearn
Functionality on Facebook Pages and Groups can differ due to API limitations. The following covers what you can do when scheduling via Aitoearn.
| Feature & Notes | Details |
|---|
| Publishing | @mentions not supported; Polls not supported; Stories support 1 image or 1 video |
| @mentions | Coming soon |
| Daily posting limit | 25 posts per 24 hours |
| Character limit | 5,000 characters per Post or Reel |
| Hashtags | Enter hashtags in the editor for Posts and Reels (Stories not supported); they become clickable after publishing |
Note: “Best Time to Post” recommendations are not available for Facebook analytics.
Image, video, and GIF specs
Facebook supports images, videos, and GIFs. Scheduling Reels is only available for Facebook Pages.
| Category | Video | Image | GIF |
|---|
| Per-post limit | 1 (upload or link) | 10 | 1 |
| Video length | Reels: 3–90s; Video: up to 4 hours; Stories: 3–60s | N/A | N/A |
| File size | Posts: ≤ 1GB; Stories: ≤ 1GB | Posts: ≤ 10MB; Stories: recommended ≤ 1MB (technical max 4MB) | ≤ 3MB |
| Dimensions / aspect ratio | Video posts: 16:9–9:16; Reels: 9:16; Stories: 9:16 | Recommended 8192×8192 | TBD |
| Supported formats | Reels: MP4; Stories: MP4; Video posts: MP4/MOV/AVI/M4V | Posts: JPG/PNG/WebP (converted to WebP after upload); Stories: JPEG/BMP/PNG/TIFF | GIF |
| Custom thumbnail | Video posts: not supported; Reels: N/A | N/A | N/A |
| Recommended frame rate | 24–60 FPS | N/A | N/A |
| Audio bitrate | ≥ 128 kbps | N/A | N/A |
| Autoplay | ✓ | N/A | ✓ |
| Alt text | N/A | ✓ | N/A |
Best practices
To keep your Facebook account healthy and avoid spam flags, stagger identical posts across multiple Pages. Publishing many identical posts at the exact same time can be flagged as spam or bot-like behavior, which may fail posts and revoke your access token. In rare cases, Facebook may temporarily restrict the account.
Example staggered schedule across five Pages:
- Page 1: 09:30
- Page 2: 09:34
- Page 3: 09:39
- Page 4: 09:42
- Page 5: 09:47
Facebook error library
Social networks sometimes reject scheduled posts and return errors. Find the error you saw below and try the suggested fix.
| Error | Cause | Resolution |
|---|
| “The daily posting limit for this channel has been reached.” | You hit the daily limit | Reduce today’s posting frequency and try again later. See “Daily posting limit”. |
| “Aitoearn lost authorization to post.” | Password changed or token expired; insufficient permissions | Re-authorize following the “Edit settings” flow in Facebook and check all required Pages/permissions, then refresh the channel connection in Aitoearn and retry. |
| “Please ensure you’re an Admin for the FB Group and Aitoearn has been added as an app.” | The connected profile isn’t a Group Admin or lacks permissions | Confirm the connected Facebook profile is a Group Admin; add the Aitoearn app in the Group’s settings per Facebook help; refresh the connection in your dashboard and retry. |
| “Please ensure you’re a Page Admin and have Two-Factor Authentication enabled.” | Insufficient Page permissions or 2FA is off | In Facebook, ensure you’re a Page Admin and enable 2FA; refresh the connection in your dashboard and retry. |
| “We had trouble uploading your media/image.” | Upload error or file size/format issue | Retry. Ensure images are JPG/PNG/HEIC and ≤ 4MB. |
| “We’re investigating a potential Facebook bug; your post may have published.” | Facebook-side publish anomaly; the post might be live | Check facebook.com to see if the post is live. If it is, delete the failed item in Aitoearn. Consider posting natively temporarily. |
| “Publishing Authorization required.” | Facebook requires publishing authorization for higher-impact Pages | Complete Facebook’s Publishing Authorization and enable 2FA; ensure location services are on; refresh the channel. |
| “Your content couldn’t be shared; it goes against our Community Standards.” | The link/content was flagged as violating standards | Try the same post directly on Facebook. If it still fails, follow Facebook’s prompt to appeal. |
| “Please log in to facebook.com and follow the prompts.” | Temporary security checkpoint | Log into Facebook and complete the prompts, then refresh the channel and retry. |
| “We’re bumping into a few Facebook page limits.” | Temporary page rate/engagement limits | Reduce posting frequency (e.g., 1 per 24 hours) and resume scheduling after engagement improves. |
| “An unknown error has occurred.” | Temporary, unknown error | Try again later; contact support if it persists. |
| “Aitoearn doesn’t have permission to post on your behalf.” | Required permissions weren’t granted during connect | Reconnect and ensure all required Pages and permissions are selected; refresh and retry. |
Tip: When reauthorizing, ensure you’re logged into the Facebook profile that is an Admin for the relevant Pages/Groups, and check all requested Pages and permissions during the authorization flow.
