Sometimes things don't go right, and that is where a troubleshooting guide comes in. If you don't see your issue here or you can't solve it, please either chat with us or email us.

Errors Linking Facebook or Instagram

If you're having issues linking your Facebook or Instagram accounts, a few potential issues might be the cause

Re-verify Facebook Login

Facebook is asking you to verify your account login again.

Open a new tab/window in your browser and go to facebook.com. Log out of Facebook and login once more. If you're asked to verify your account or a CAPTCHA question, please complete it.

Head back to the Ayrshare dashboard Social Accounts page, refresh your page, and try linking Facebook once more.

Note: Please be sure that a Facebook Page is linked with your Facebook account. This is require to link to Facebook and you will be asked to select the Page to link and post.

Facebook or Instagram Account is New

If you receive the error: "Could not link Ayrshare to Facebook. You may not be connected to the network or we could not establish a connection with our server. Check your connection and try again later."

The cause might be you're using a newly created Facebook or Instagram account. Facebook states that "There is a 60-minute delay before new accounts can log in to any applications".

Please wait 60-minutes and try again.

Your Instagram Account Must Be a Business Account and Linked to a Facebook Page

Please here for details:

Trouble Posting to Facebook

If you receive an error when posting about Facebook permission issues or that your account isn't linked, even though you linked your Facebook account, it could be some access permissions were not granted.

Log into Facebook and go to the "Setting" -> "Settings & Privacy" -> "Security & Login" -> "Business Integration".

Click here for a direct link: https://www.facebook.com/settings?tab=business_tools&ref=settings​

On the Business Integration page, click the Ayrshare App.

A pop-up will show. Scroll down to "Create and Manage Content on Your Page" and check the box "Pages" to select all pages:

Click "Save".

Head back to the Ayrshare Dashboard and unlink and relink Facebook. You should now have the correct permissions.

Trouble Posting to Instagram

If you receive an error when posting about Instagram permission issues or that your account isn't linked, even though you linked your Facebook account, it could be some access permissions were not granted.

First, please be sure your Instagram is a Business account and it is connected to a Facebook Page. See here for details.

Nest, log into Facebook and go to the "Setting" -> "Settings & Privacy" -> "Security & Login" -> "Business Integration".

Click here for a direct link: https://www.facebook.com/settings?tab=business_tools&ref=settings​

On the Business Integration page, click the Ayrshare App.

A pop-up will show. Scroll down to "Upload media and create post for Instagram" and "Access profile and posts for Instagram". Check both the boxes "Instagram Accounts":

Click "Save".‌

Head back to the Ayrshare Dashboard and unlink and relink Instagram. You should now have the correct permissions.

Post with @mentions didn't go through

The social networks are very particular on the frequency of @mentions and who is mentioned. The Free Plan does not allow mentions and will not send your posts. Paid plans allow mentions, but the same mention can not be used twice within a 7 day period.

Errors making requests with the API

A few things to check to verify you have all the required information to successfully post, or call any API endpoint.

1. Verify you are sending the API_KEY, found in the Ayrshare GUI dashboard under API Dashboard, in the header as an Authorization Bearer token. Also the proper Content Type must be set.

2. For POST calls, validate properly formatted JSON is being sent in the body. Online tools can assist: https://jsonlint.com/​

3. If sending media via an external URL, make sure the proper MIME type is set for the image or video.

4. Review the required endpoint's required parameters to be sure they are included and have the proper format.

Get an Unsplash Image URL

If copying an Unsplash URL to post in media_urls, please be sure to copy the image address.

Click on the Unsplash image you want to copy, right click the image, and select "Copy Image Address".

Twitter Link Preview Not Showing

When a link is included in a post, Twitter tries to render a preview. Twitter meta tags on your site/page in the header are used to render the preview text, image, and link.

You can validate how the Twitter card will look by submitting your page link here:

If everything looks ok, but the preview is still not showing, please contact us for assistance.

Response Returns as "Bad Request"

If you receive HTML as a response of "Bad Request" instead of JSON, it is possible the POST body parameter is not valid JSON.

For example, if you send this invalid JSON:

{
    "post": "A great post"
    "platforms: ["twitter"]
}

A response of "Bad Request" will be returned. The code above has two issues: a missing comma on postand a missing end quote on platform. The valid JSON should be:

{
    "post": "A great post",
    "platforms": ["twitter"]
}

You can test your JSON by POSTing to the following URL to validate your JSON. Be sure to set the Content-Type to text/plain.

Valid JSON. Nice Job!

JSON is not valid. So sorry...

const fetch = require("node-fetch");
​
fetch("https://app.ayrshare.com/validateJSON", {
      method: "POST",
      headers: {
        "Content-Type": "text/plain",
      },
      body: JSON.stringify({
        post: "Today is a great day!", // required
        platforms: ["twitter", "facebook", "instagram", "linkedin"], // required
        mediaUrls: ["https://images.ayrshare.com/imgs/GhostBusters.jpg"], //optional
      }),
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);