Ayrshare Error Codes

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 110,
      "message": "Status is a duplicate.",
      "post": "Today is a great day",
      "platform": "twitter"
    },
    {
      "action": "post",
      "status": "error",
      "code": 107,
      "message": "Facebook Error: This status update is identical to the last one you posted.
        Try posting something different, or delete your previous update.",
      "platform": "facebook"
    }
  ],
  "postIds": [],
  "id": "6APU4qqI7XO7JM3BOy6B"
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 161,
      "message": "Facebook authorization error. This can occur if your Facebook security changes. Try unlinking and re-linking Facebook or contact us for assistance.",
      "platform": "facebook"
    }
  ],
  "postIds": [],
  "id": "gh7SyTpeD2CQAMxWk3oh",
  "post": "A great Facebook Posts"
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 138,
      "message": "Instagram Error: There was an issue posting to Instagram. The submitted image with aspect ratio ('1440/2158',) cannot be published. Please submit an image with a valid aspect ratio.",
      "platform": "instagram"
    }
  ],
  "postIds": [],
  "id": "Jxe2nMM3FmEvMXFSY3g4",
  "post": "Is this a good image?"
}

{
  "action": "quota limit",
  "status": "error",
  "code": 106,
  "message": "You have exceeded your API quota for the month. Please see our upgrade plans. https://www.ayrshare.com/pricing/"
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 137,
      "message": "Duplicate or similar content posted within the same two day period. The social networks prohibit duplicate content and ban accounts that do not comply. https://www.ayrshare.com/docs/help-center/technical-support/dealing_with_duplicate_posts#dealing-with-duplicate-posts",
      "platform": "twitter"
    }
  ],
  "postIds": [],
  "id": "Jxe2nMM3FmEvMXFSY3g4"
}

{
  "status": "error",
  "errors": [
    {
      "action": "rate limit",
      "status": "error",
      "code": 435,
      "message": "Instagram rate limit reached. Please wait before retrying your post.",
      "details": "Retry-After: 3600",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 436,
      "message": "Instagram media processing timed out. Please try posting again.",
      "retryAvailable": true,
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 447,
      "message": "Instagram trial reels require instagramOptions.trialParams.graduationStrategy (\"MANUAL\" or \"SS_PERFORMANCE\").",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 448,
      "message": "Invalid Instagram graduationStrategy. Must be \"MANUAL\" or \"SS_PERFORMANCE\".",
      "details": "Received: manual",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 449,
      "message": "Instagram trial reels must be a single video (.mp4 or .mov) — carousels and stories are not supported.",
      "details": "Carousels are not supported.",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 258,
      "message": "Error with Instagram.",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 258,
      "message": "Instagram reported a temporary internal error while publishing (Meta error 2207085 - Generic Internal Error). This is a Meta-side condition and usually resolves on its own - please retry the post in a few minutes. If the error persists beyond 24-48 hours, unlink and relink your Instagram account on the Social Accounts page, granting all permissions on the Meta authorization screen, or contact Meta support with the trace ID provided in the details field of this error response.",
      "retryAvailable": true,
      "details": "Meta fbtrace_id: AMzDbKKh3d7n-oufgbiTut5",
      "platform": "instagram"
    }
  ]
}

{
  "retryAvailable": true
}

{
  "status": "failed",
  "commentId": "18012345678905555",
  "actionResults": [
    {
      "type": "send_dm",
      "status": "failed",
      "errorDetails": "Cannot send private reply: This comment is no longer eligible for a private reply."
    }
  ]
}

{
  "action": "messages",
  "status": "error",
  "code": 491,
  "message": "Instagram would not accept a private reply to this comment. The comment may be more than 7 days old, may already have a reply, may have been deleted, or the commenter may not allow message requests.",
  "details": "Cannot send private reply: This comment is no longer eligible for a private reply.",
  "platform": "instagram"
}

{
  "status": "error",
  "code": 272,
  "message": "Failed to verify BYO Twitter identity",
  "platform": "twitter"
}

{
  "action": "post",
  "status": "error",
  "code": 272,
  "message": "There is an issue authorizing your X/Twitter account. Login to x.com to verify your account status and then try unlinking Twitter and relinking on the social accounts page.",
  "resolution": {
    "relink": true,
    "platform": "twitter"
  },
  "details": "The user used for authentication is suspended"
}

{
  "action": "rate limit",
  "status": "error",
  "code": 364,
  "message": "You are making too many requests. Please reduce the number of requests.",
  "platform": "twitter"
}

{
  "status": "error",
  "code": 416,
  "message": "Your X Developer account has no API credits. Purchase credits at https://console.x.com (Billing → Credits). Even $5 is enough for hundreds of API calls.",
  "details": "Your enrolled X Developer account 1234567890 has no API credits. Your enrolled account does not have any credits to fulfill this request. Purchase credits at console.x.com.",
  "platform": "twitter"
}

{
  "status": "error",
  "code": 417,
  "message": "Your client app is not configured with the appropriate oauth1 app permissions. Set app to 'Read and write and Direct message', then regenerate your Access Token.",
  "platform": "twitter"
}

{
  "action": "x_credentials_required",
  "status": "error",
  "code": 419,
  "message": "X/Twitter operations require your own API credentials. Missing: X-Twitter-OAuth1-Api-Key, X-Twitter-OAuth1-Api-Secret. Please provide your X Developer App credentials in the request headers. See https://docs.ayrshare.com/x-api-setup for setup instructions.",
  "resolution": {
    "docs": "https://docs.ayrshare.com/x-api-setup"
  },
  "platform": "twitter"
}

{
  "action": "x_credentials_required",
  "status": "error",
  "code": 419,
  "message": "You provided X-Twitter-OAuth1-Api-Key but not X-Twitter-OAuth1-Api-Secret. OAuth 1.0a requires both. Missing: X-Twitter-OAuth1-Api-Secret. See https://docs.ayrshare.com/x-api-setup for setup instructions.",
  "resolution": {
    "docs": "https://docs.ayrshare.com/x-api-setup"
  },
  "platform": "twitter"
}

{
  "status": "error",
  "code": 423,
  "message": "X (Twitter) API access now requires your own API credentials. Include X-Twitter-OAuth1-Api-Key and X-Twitter-OAuth1-Api-Secret headers in your request. Setup guide: https://docs.ayrshare.com/dashboard/connect-social-accounts/x-twitter-byo-keys",
  "platform": "twitter"
}

{
  "status": "error",
  "errors": [
    {
      "platform": "twitter",
      "status": "error",
      "source": "handlePostAdditions",
      "code": 441,
      "message": "Caption enhancement failed for twitter. <underlying error>. Post was not sent to this platform."
    }
  ],
  "postIds": [
    {
      "status": "success",
      "id": "...",
      "postUrl": "...",
      "platform": "bluesky"
    }
  ],
  "id": "..."
}

{
  "status": "error",
  "action": "post",
  "code": 441,
  "message": "Caption enhancement failed. See error details for affected platforms.",
  "errors": [
    {
      "platform": "twitter",
      "status": "error",
      "source": "handlePostAdditions",
      "code": 441,
      "message": "Caption enhancement failed for twitter. <underlying error>"
    }
  ]
}

{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 499,
    "retryAvailable": true,
    "message": "Ayrshare's media probe service is temporarily unavailable. Please retry shortly.",
    "platform": "facebook"
  }]
}

{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 440,
    "message": "The social network could not download media from this URL (for example Instagram/Meta error 2207052). Ensure the file is publicly reachable by the platform's crawlers (e.g. facebookexternalhit), via media bucket's robots.txt file, not only in a browser.",
    "details": "Media download has failed.: The media could not be fetched from the provided URI...",
    "platform": "instagram",
    "status": "error"
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "retryAvailable": true,
    "status": "error",
    "code": 138,
    "details": "Media download has failed.: The media could not be fetched from the provided URI. Video download failed with: HTTP error code 403. Restricted by robots.txt",
    "action": "post",
    "platform": "instagram",
    "message": "Instagram Error: Instagram cannot process your post at this time. Please try your post again."
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "status": "error",
    "code": 379,
    "message": "Error posting to Threads.",
    "action": "post",
    "platform": "threads"
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "action": "post",
    "status": "error",
    "code": 522,
    "message": "Threads Error: Threads was not ready to publish this post, even after Ayrshare waited and retried. This is usually temporary. Please try posting to Threads again. https://www.ayrshare.com/docs/errors/errors-ayrshare#threads-media-not-ready",
    "retryAvailable": true,
    "noAutoRetry": true,
    "platform": "threads"
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "facebook": {
    "action": "rate limit",
    "status": "error",
    "code": 444,
    "errCode": 80001,
    "message": "Facebook Page has hit its per-Page rate limit on the analytics endpoint. Please wait a few minutes and retry.",
    "pageId": "...",
    "id": "..."
  },
  "httpErrorCode": 444,
  "lastUpdated": "...",
  "nextUpdate": "..."
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 326,
      "message": "Meta is requesting additional identity verification for this account. Complete it at https://www.facebook.com/business-support-home and then retry. Reconnecting the account will not resolve this.",
      "platform": "facebook"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 249,
      "message": "Facebook blocked this post under its Community Standards. The block is often placed on the Facebook account or Page rather than on the post itself, and Facebook does not return the specific reason through the API. Log in to Facebook, click your profile picture (top-right), open the Help section and select Account Status to see the reason and appeal.",
      "details": "...",
      "platform": "facebook"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 476,
      "message": "There is a Facebook restriction on your account. Log in to Facebook, click your profile picture (top-right), open the Help section and select Account Status. Meta's support assistant there surfaces the specific restriction reason (which the API doesn't return) and lets you appeal.",
      "details": "...",
      "platform": "facebook"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "image conversion",
      "status": "error",
      "code": 450,
      "message": "The image format could not be converted. The source image may be corrupt or inaccessible. Please verify the media URL and try again.",
      "platform": "instagram"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "image conversion",
      "status": "error",
      "code": 451,
      "message": "The image could not be downloaded for format conversion.",
      "details": "HTTP 403 from origin",
      "platform": "linkedin"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "image conversion",
      "status": "error",
      "code": 452,
      "message": "An error occurred uploading the converted image. Please try again.",
      "platform": "tiktok"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 453,
      "message": "YouTube upload timed out (Google ingest). This is typically transient; please retry in 1–2 minutes.",
      "retryAvailable": true,
      "platform": "youtube"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 454,
      "message": "YouTube upload service temporarily unavailable. Please retry.",
      "retryAvailable": true,
      "platform": "youtube"
    }
  ]
}

{
  "status": "success",
  "id": "<videoId>",
  "thumbnail": {
    "action": "post",
    "status": "error",
    "code": 307,
    "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
    "details": "<upstream message>"
  },
  "warnings": [
    {
      "feature": "thumbnail",
      "code": 307,
      "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
      "details": "<upstream message>"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "authorization",
      "status": "error",
      "code": 519,
      "message": "Google Business Profile authorization service temporarily unavailable. Please retry.",
      "details": "<upstream reason, or the timeout summary>",
      "retryAvailable": true,
      "platform": "gmb"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 442,
      "message": "You've been banned from posting to r/news. This post will not succeed on retry — remove it from your target subreddits.",
      "platform": "reddit"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 443,
      "message": "r/news rejected this post because the title contains a disallowed word. Edit the title before retrying — retrying as-is will not succeed.",
      "platform": "reddit"
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "moderation",
      "status": "error",
      "code": 438,
      "message": "There was an issue with the AI processing."
    }
  ]
}

{
  "status": "error",
  "errors": [
    {
      "action": "authorization",
      "status": "error",
      "code": 524,
      "message": "LinkedIn could not refresh the authorization. You do not need to relink LinkedIn. Please contact support.",
      "retryAvailable": false,
      "platform": "linkedin"
    }
  ]
}

{
  "action": "authorization",
  "status": "error",
  "code": 475,
  "message": "Your LinkedIn profile is missing the analytics permissions. Please re-link your LinkedIn profile to enable analytics.",
  "resolution": {
    "relink": true,
    "platform": "linkedin"
  }
}

{
  "status": "error",
  "errors": [
    {
      "action": "get",
      "status": "error",
      "code": 288,
      "message": "TikTok video is still processing; the action is deferred until the post is live.",
      "platform": "tiktok"
    }
  ]
}

{
  "facebook": [
    {
      "comment": "What a great comment",
      "commentId": "806720068141593_1849585385469876",
      "created": "2026-07-14T19:55:28Z",
      "likeCount": 12,
      "platform": "facebook"
    }
  ],
  "status": "partial",
  "id": "Ut2fWU6XkqkMayHGnJZ7",
  "lastUpdated": "2026-07-14T22:30:13.035Z",
  "nextUpdate": "2026-07-14T22:41:13.035Z",
  "errors": [
    {
      "platform": "instagram",
      "status": "error",
      "code": 485,
      "message": "Instagram Story expired or unavailable — comments/insights cannot be retrieved.",
      "id": "17895695668004550"
    }
  ]
}

{
  "facebook": {
    "id": "1397547544885713_2159201585286968",
    "postUrl": "https://www.facebook.com/1397547544885713_2159201585286968",
    "analytics": {
      "commentsCount": 1,
      "likeCount": 23,
      "sharesCount": 12,
      "mediaView": 450
    },
    "lastUpdated": "2026-07-14T18:44:29.778Z",
    "nextUpdate": "2026-07-14T19:19:29.778Z"
  },
  "status": "partial",
  "id": "IHvCLacgPc6hMU9IQ6oK",
  "errors": [
    {
      "platform": "instagram",
      "status": "error",
      "code": 485,
      "message": "Instagram Story expired or unavailable — comments/insights cannot be retrieved.",
      "id": "17895695668004550"
    }
  ]
}

"Translate-Error-Message": "Language_Code"

"Translate-Error-Message": "fr" // Translate to French