Getting started
- Create an Instagram professional account
- Connect Instagram to Hookle
- Publish to Instagram with Hookle
Troubleshoot
- Post was not published or is Failed
- Cannot connect Instagram to Hookle (or change credentials)
- Have you done changes to your Instagram settings?
- Error "cannot load picture" when posting to Instagram
- Are you using the right image size?
- How to delete a post on Instagram?
- Why send button is disabled
- Instagram private accounts
- Stories and Tagging
- Reset Hookle in your Instagram app permissions
Error codes
- ERROR CODE: Limit for a maximum number of posts within 24h
- ERROR CODE: Permission problem. Please ensure you are using Instagram business account
- ERROR CODE: Instagram account is blocked. Please check the account status in Instagram
- ERROR CODE: The Instagram account is restricted
- ERROR CODE: #10 Application doesn't have permission for this action
- ERROR CODE: You can have max 30 hashtags in a post
- ERROR CODE: This post is identical to the last one you published.
- ERROR CODE: We restrict certain activity to protect our community
- ERROR CODE: Fatal
- ERROR CODE: The video format is not supported
Troubleshoot
Post was not published or is Failed
Reconnect the account:
Your Instagram access token might have expired. To fix that, reconnect your accounts.
Error codes:
See also these error codes for troubleshooting failed posts.
Cannot connect Instagram to Hookle (or change credentials)
See instructions on how to connect Instagram to Hookle.
Have you done changes to your Instagram settings?
Changes to settings might result in token expiration. To fix that, reconnect your accounts. Make sure you accept all the required permissions while reconnecting accounts to Hookle.
Error "cannot load picture" when posting to Instagram
Please make sure you have the latest Instagram app installed on your phone. If not, please update the Instagram app on Google Play or Apple Store!
Are you using the right image size?
To successfully share photos on Instagram, it's important to keep two main factors in mind: aspect ratio and size. If your images don't meet the Instagram image size requirements, Hookle will automatically crop them before publishing. To avoid this, it's recommended to crop your images yourself before publishing. See the image size guide below or read more about image sizes.
How to delete a post on Instagram?
First sign in to the Instagram app. Then choose the picture and click delete on the menu.
With Hookle, you cannot currently delete a post that is already published on Instagram. We will introduce the delete feature in the future. Please subscribe to our newsletter to stay informed!
Why send button is disabled
Please ensure you have added an Instagram account for your post. Additionally, you need to add content (at least a picture or video) as an empty message cannot be sent.
Instagram private accounts
To be able to use 3rd party apps such as Hookle, Instagram professional accounts must not be set to private. This is an Instagram's requirement.
Tagging
Due to Instagram limitations, tagging (people, products, and location) are not possible currently. We are in close collaboration with Instagram to get these features available asap. Stay tuned by subscribing to our newsletter to be the first to hear about new features and more.
Reset Hookle in your Instagram App Permissions
Sometimes just reconnecting accounts is not enough, and you need to remove Hookle from your Instagram App Permissions (open your Instagram app -> Settings -> App website permissions -> Apps and websites -> Hookle -> Remove). Then go back to Hookle and (re)connect your Instagram accounts again to Hookle.
ERROR CODES
You will find an error code or description in the details view of the failed post if your post has failed. Find different error codes and how to fix them below.
ERROR CODE: Limit for a maximum number of posts within 24h
ERROR CODE: You reached a maximum number of posts within 24h that is allowed by Instagram. Please try again later OR You reached a maximum number of posts that are allowed to be published by Content Publishing API.
Instagram only allows you to publish a maximum of 50 posts within 24 hours (when you use direct posting) so you need to wait and retry later.
ERROR CODE: Permission problem. Please ensure you are using an Instagram business account
ERROR CODE: Permission problem. Please ensure you are using Instagram business account.
You have most probably published a post to an Instagram account, which is not a professional account. Please check your Instagram account type and switch to professional if needed.
ERROR CODE: Instagram account is blocked. Please check the account status in Instagram
ERROR CODE: Instagram account is blocked. Please check the account status in Instagram.
Instagram has blocked your account for some reason, typically because their automated algorithm flagged your post or publishing activity as spam. Please open the Instagram app to check your account status and follow their onscreen instructions to resolve the issue.
Additionally, you may need to check the Meta Accounts Center or Meta Business Suite for your Instagram account status and follow any instructions provided there to fix the issue.
ERROR CODE: The Instagram account is restricted
Your Professional account has been made inactive, checkpointed, or restricted by Instagram. This usually occurs when the Instagram algorithm detects activity that violates the Community Guidelines or Terms of Use. We recommend that you sign into your Instagram app and follow any on-screen instructions required to re-enable your account.
ERROR CODE: #10 Application doesn't have permission for this action
Sometimes the permissions (that you or the company gave) expire due to Instagram security measures. This might happen e.g. because of a new password, a change of 2-factor authentication, or because you don't have the Admin or Editor rights to the page anymore.
First, check your Instagram account is in professional mode. Then, make sure you've given Hookle all the necessary permissions.
Then go back to Hookle and try to publish your post again (click retry on post details view).
ERROR CODE: You can have max 30 hashtags in a post
ERROR CODE: This post is identical to the last one you published.
ERROR CODE: We restrict certain activity to protect our community.
ERROR CODE: We restrict certain activity to protect our community. Tell us if you think that we've made a mistake.
The content was labeled spam by Instagram. Instagram restricts certain activity to protect their community if the publishing action is suspected to be spam. There might be several reasons why you get this error such as:
- Your Account Is Relatively New
- Instagram might restrict a certain activity if you have been inactive for a long time
- Other Instagram users have reported your Instagram account
- Instagram noticed unusual behavior
- You are using Instagram bots
To try to fix this error try the following approaches:
- Stop overdoing activities
- Fill in your profile info such as phone number and the right email address
- Stop using bots
- Let Instagram know if you can determine that the publishing actions is not spam.
ERROR CODE: Fatal
ERROR CODE: Fatal (code -1, subcode 2207001)
Error 2207001 indicates a temporary issue with Instagram's servers, prompting a post retry later. To address this, try to publish (retry) the post again. If it didn't help, duplicate the post (use copy as a new post feature) and publish it again.
As Instagram's anti-spam mechanism triggers this error and they don't provide specific details to prevent abuse, try posting a new version with amendments or changes.
Another tip is to space out your posts or reduce the number of uploads at once.
ERROR CODE: The video format is not supported
ERROR CODE: The video format is not supported. Please check the specs for the supported CodedException format (code 352, subcode 2207026)
Unsupported video format. This is most commonly due to an incorrect video format. Please upload an MOV or MP4 (MPEG-4 Part 14). You can also review the specific video requirements (reel specifications) here.