Instagram Single Image Post Automation via Facebook Graph API - n8n Workflow

Social Media Managers needing reliable automated posting solutions.
Agencies managing multiple Instagram accounts looking for robust n8n templates.
Developers seeking an effective n8n workflow for interacting with Instagram APIs.
Users looking to implement flow control and error checking in their n8n node processes.

This comprehensive n8n workflow addresses the complexity of posting to Instagram via the Facebook Graph API, which strictly requires two steps: preparing the media container (uploading) and then publishing it. Unlike simpler integrations, this robust n8n workflow incorporates critical error handling using If n8n nodes. It systematically checks if the image upload status is FINISHED before attempting publication, and then checks the final publication status. This ensures that the overall n8n solution is highly reliable, providing automated notification on failure or success. Utilizing this advanced n8n template allows users to maintain consistent and safe social media output while leveraging the power of n8n automation.

1. The n8n workflow is initiated by the When clicking ‘Test workflow’ n8n trigger (which should be replaced with a scheduler or webhook for production).


2. The Instagram params n8n node sets the required dynamic data points: the image URL, the Instagram Business Account ID, and the post caption.


3. The Instagram prepare media n8n node sends a POST request to the Facebook Graph API to create a media container, uploading the image and caption. This is the first critical step in the n8n posting process.


4. The Instagram check status of media uploaded before n8n node immediately checks the status of the media container created in the previous step.


5. The If media status is finished n8n node acts as the primary flow control gate. If the status is FINISHED, the n8n workflow proceeds to publication. If the status is not ready, the workflow branches to send a failure notification (Send Email).


6. If successful, the Instagram publish media n8n node executes the final POST request to publish the media to the linked Instagram Business Account.


7. The subsequent Instagram check status of media published before n8n node verifies the outcome of the final posting action.


8. Finally, the If media status is finished1 n8n node checks if the final status is PUBLISHED. It routes the n8n workflow to send a success email (Send Email1) or a failure email (Send Email2), concluding this automated n8n node sequence.

1. Importing the n8n workflow: Copy the provided JSON data and use the 'Import from JSON' option within your n8n instance to set up this n8n template.


2. Credential Setup: Create or verify your existing Facebook Graph API/Instagram API credentials. This credential must be linked to all Facebook Graph API n8n nodes. Ensure your Facebook App has the necessary permissions (e.g., instagramcontentpublish).


3. Parameter Configuration: Open the Instagram params n8n node and update the three placeholder values to match your specific requirements:

1. Trigger Modification: Replace the default When clicking ‘Test workflow’ n8n trigger with a production-ready n8n trigger, such as a Schedule or Webhook n8n node, based on how you intend to initiate this n8n workflow.


2. Activation: After testing the flow manually to ensure all n8n node connections are valid, activate the n8n workflow.

Manual Trigger (When clicking ‘Test workflow’): The initial n8n trigger designed for development and manual testing. It must be swapped for a production n8n trigger.
Set (Instagram params): A crucial n8n node used to define and inject the required image URL, caption, and Instagram ID into the data stream.
Facebook Graph API (Instagram prepare media): Handles the initial media upload. Key Configuration: httpRequestMethod: POST, edge: media. This n8n node creates the media container.
Facebook Graph API (Instagram check status of media uploaded before): An integral part of the n8n template for checking the preparation status using the returned media ID.
If (If media status is finished): A flow control n8n node checking if the upload statuscode is FINISHED before proceeding to the final publishing step.
Facebook Graph API (Instagram publish media): Executes the final publishing command. Key Configuration: httpRequestMethod: POST, edge: mediapublish, using the creation_id from the preparation step.
If (If media status is finished1): The final n8n node for status checking, confirming if the post is PUBLISHED to route the n8n workflow to the correct notification channel.
Email Send (Multiple instances): These n8n nodes are placeholders for sending success and failure notifications, demonstrating comprehensive error handling within the n8n workflow.