Actions12
Overview
This node enables creating and publishing content to Instagram, Facebook, and Threads via their respective APIs. Specifically for Instagram, it supports creating various types of posts including photo posts, video posts, reels, carousel posts, and stories on an Instagram Business Account.
The Create Photo Post operation for Instagram allows users to publish a single photo with an optional caption to their Instagram Business Account. This is useful for automating social media marketing workflows, scheduling posts, or integrating Instagram content creation into larger automation pipelines.
Practical example:
A marketing team can use this node to automatically post product images with promotional captions to their Instagram Business Account whenever new products are added to their e-commerce platform.
Properties
| Name | Meaning |
|---|---|
| Instagram Business Account ID | The unique identifier of the Instagram Business Account where the photo will be posted. |
| Image URL | The publicly accessible URL of the image to be posted on Instagram. |
| Caption | Optional text caption to accompany the photo post on Instagram. |
Output
- The output JSON contains the response from the Instagram Graph API after publishing the photo post.
- Typically, this includes an
idfield representing the published media object. - No binary data is output by this operation.
Example output structure (simplified):
{
"id": "17895695668004550"
}
This id can be used to reference the created Instagram media post.
Dependencies
- Requires an API authentication token credential configured in n8n that has permissions to access the Facebook Graph API for Instagram Business Accounts.
- The node makes HTTP POST requests to the Facebook Graph API endpoints under the base URL
https://graph.facebook.com/v23.0. - The Instagram Business Account must be linked to a Facebook Page and authorized for API access.
Troubleshooting
Common issues:
- Invalid or missing Instagram Business Account ID will cause API errors.
- The image URL must be publicly accessible; private or inaccessible URLs will fail.
- Insufficient permissions or expired API tokens will result in authentication errors.
- Posting too frequently may trigger rate limits from the Instagram API.
Error messages:
- Errors returned from the API include detailed error codes and messages, e.g., permission denied, invalid parameter, or media not found.
- The node surfaces these errors with descriptive messages like
Facebook/Instagram/Threads API Error: <error message>. - To resolve, verify credentials, ensure correct account IDs, and confirm the image URL accessibility.
Continue on Fail:
- If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output JSON.
Links and References
- Instagram Graph API - Publishing Photos
- Facebook Graph API Documentation
- n8n Documentation - HTTP Request Node (for understanding underlying HTTP calls)