Hey, I’ve run into this exact issue with The Grid and Instagram API before—let’s break down what’s happening and how to fix it.

Problem Analysis #

The error message "Sorry, an error occurs from Instagram API: This endpoint has been retired" tells us straight up: the Instagram API endpoint The Grid is trying to use has been officially discontinued by Meta. This usually happens when:

• The plugin is using an outdated Graph API version (Meta retires older versions regularly, e.g., v17.0 and below are no longer supported)
• Your new Access Token doesn’t meet current API requirements (like missing permissions or not being tied to a Facebook Page)

Solutions #

1. Update The Grid to the Latest Version #

• This is the fastest fix. Plugin developers almost always push updates to align with Instagram API changes. Head to your WordPress Dashboard > Plugins, check if The Grid has an available update, install it, then re-configure your Access Token. 9 times out of 10, this resolves the issue.

2. Validate Your Access Token’s Compliance #

Instagram’s Graph API now has strict requirements for valid tokens:

• You must use Graph API v18.0 or newer
• Your Instagram account must be a Business or Creator account (personal accounts can’t use Graph API for media retrieval)
• The token must be linked to a Facebook Page (required for all business/creator account API access)
• The token needs these permissions: instagram_basic, pages_show_list

3. Regenerate a Compliant Access Token #

If your current token doesn’t meet the above, follow these steps to create a new one:

• Log into the Facebook Developer Portal, navigate to your app, and ensure it’s either in "Live" mode (for public use) or add test users if in "Development" mode
• Go to Products > Instagram Graph API, link your Instagram Business/Creator account to a Facebook Page
• Use the Graph API Explorer to generate a short-lived token first, then convert it to a long-lived token (valid for 60 days, refreshable) by calling GET /{page-id}?fields=access_token
• Paste this new long-lived token into The Grid’s Instagram settings, save, and test

4. Emergency Fix: Manually Update API Endpoints (Not Recommended) #

If The Grid hasn’t released an update yet, you can temporarily modify the plugin’s code (note: this will be overwritten when you update the plugin later):

• Access your site via FTP or WordPress’s File Editor, navigate to wp-content/plugins/the-grid
• Search for outdated API endpoints (look for patterns like /v[0-9]+/instagram/user/media)
• Replace them with the latest Graph API endpoint: /v18.0/{ig-user-id}/media (replace {ig-user-id} with your actual Instagram User ID)
• Clear the plugin’s cache and reload your page to test

5. Reach Out to The Grid’s Official Support #

If none of the above works, it’s likely a plugin-specific bug that hasn’t been patched. Submit a support ticket through The Grid’s official channel, share your error message and steps you’ve tried, and their team will provide a targeted fix.

内容的提问来源于stack exchange，提问作者RJ Design World