Facebook Graph API

Facebook API Errors

Facebook Graph API publishing errors — auth, page permissions, content policy, and rate limits.

Facebook's Graph API error codes are notoriously cryptic seven-digit numbers. This page maps each one to what actually went wrong.

PostPeer Facebook API View Docs

Authentication4 Media1 Rate limit1 Policy4 Content3 Server2

Authentication

4 errors in this category

INVALID_ACCESS_TOKENAuthentication

Token failed validation at Meta's auth layer.

Why it happens: Token is malformed, expired, or signed against a client secret that has since rotated.
How to fix: Reconnect to mint a fresh long-lived page token.
How PostPeer handles it: PostPeer stores long-lived (60-day) page tokens and refreshes them on every publish to extend their life.

490HTTP 401Authentication

Facebook session expired.

Why it happens: Time-based expiry hit or the user changed their password.
How to fix: Reconnect the Page.

REVOKED_ACCESS_TOKENAuthentication

User revoked the token from Facebook → Business Integrations.

Why it happens: Common when end-users audit their connected apps and remove old integrations.
How to fix: Reconnect with the same user/page selection.

1404078Authentication

Page lacks `pages_manage_posts` permission.

Why it happens: During the connect flow the user did not grant the page-management scope, or selected a page they don't admin.
How to fix: Reconnect, grant all requested scopes, and pick a page the user actually administers.

Media

1 error in this category

1366046Media

Image is over 4MB or in an unsupported format.

Why it happens: Facebook's Pages publish endpoint caps photos at 4MB and only accepts JPG/PNG.
How to fix: Compress or convert. PostPeer auto-compresses on upload.

Rate limit

1 error in this category

1390008HTTP 429Rate limit

"You are posting too fast" — page-level throttle.

Why it happens: Facebook throttles bursts to prevent automated spam.
How to fix: Space posts out by at least a few minutes. PostPeer paces sends automatically when possible.

Policy

4 errors in this category

1346003Policy

Content flagged as abusive or policy-violating.

Why it happens: Automated Meta classifiers flagged language, imagery, or links.
How to fix: Review the post against Facebook Community Standards and rewrite or drop the flagged element.

1404006Policy

Security check required before posting.

Why it happens: Account or page is under review and the user must complete a check in the Facebook app.
How to fix: Have the user log into Facebook directly and complete the prompted security challenge.

1404102Policy

Content violates Facebook Community Standards.

Why it happens: Hard policy violation.
How to fix: Rewrite to comply or skip the platform for this piece.

1609008Policy

Cannot post a `facebook.com` link.

Why it happens: Facebook blocks self-referential links in API posts (a long-standing anti-spam measure).
How to fix: Remove the facebook.com URL or replace with a non-Facebook domain.

Content

3 errors in this category

2061006Content

URL in the post is malformed.

Why it happens: Missing protocol (`http://` / `https://`) or unparseable URL structure.
How to fix: Always include the protocol prefix; URL-encode if needed.

1349125Content

Post structure does not match the API contract.

Why it happens: Wrong combination of `message`, `link`, `media`, `child_attachments`.
How to fix: Use the Graph API's `/me/feed` documentation as ground truth.

NAME_TOO_LONGContent

Post text exceeds the 63,206-character limit.

Why it happens: Yes, Facebook really allows ~63k characters per post.
How to fix: Split into multiple posts or trim.

Server

2 errors in this category

1363047HTTP 503Server

Facebook service temporarily unavailable.

Why it happens: Transient outage in the publish path.
How to fix: Retry — usually clears in minutes.

1609010HTTP 503Server

Service disruption.

Why it happens: Same shape as 1363047 from a different upstream.
How to fix: PostPeer auto-retries these.

Quick reference

All 15 Facebook errors in one table — Ctrl/Cmd-F to find yours.

Code	Category	What it means
INVALID_ACCESS_TOKEN	Authentication	Token failed validation at Meta's auth layer.
490	Authentication	Facebook session expired.
REVOKED_ACCESS_TOKEN	Authentication	User revoked the token from Facebook → Business Integrations.
1404078	Authentication	Page lacks `pages_manage_posts` permission.
1366046	Media	Image is over 4MB or in an unsupported format.
1390008	Rate limit	"You are posting too fast" — page-level throttle.
1346003	Policy	Content flagged as abusive or policy-violating.
1404006	Policy	Security check required before posting.
1404102	Policy	Content violates Facebook Community Standards.
1609008	Policy	Cannot post a `facebook.com` link.
2061006	Content	URL in the post is malformed.
1349125	Content	Post structure does not match the API contract.
NAME_TOO_LONG	Content	Post text exceeds the 63,206-character limit.
1363047	Server	Facebook service temporarily unavailable.
1609010	Server	Service disruption.

Other platforms

Instagram errors

33 documented

X (Twitter) errors

12 documented

TikTok errors

25 documented

LinkedIn errors

9 documented

Bluesky errors

10 documented

Pinterest errors

8 documented

Threads errors

7 documented

YouTube errors

15 documented

Ready to Add Social Media to Your Product?

One API. Every platform. Start building with free credits.

Start Posting for FreeNo credit card required.

POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin", "instagram], "content": "Hello world!" }

Published

5 platforms

TwitterLinkedInFacebook+2

All posts delivered

Scheduled

queue

Queued

847

Sent

Next: in 15 min

Platforms

connected

XIGFBLITT

One API, every platform