Actions12
Overview
This node enables users to create and publish video posts on Instagram Business Accounts via the Facebook Graph API. It is designed for automating content publishing workflows, such as scheduling marketing videos or sharing product demos directly to Instagram from other systems.
Typical use cases include:
- Automatically posting promotional videos to an Instagram Business Account.
- Sharing event highlight reels or announcements without manual intervention.
- Integrating Instagram video publishing into broader social media management pipelines.
For the "Create Video Post" operation, the node uploads a video URL with an optional caption and publishes it as a new post on the specified Instagram Business Account.
Properties
| Name | Meaning |
|---|---|
| Instagram Business Account ID | The unique identifier of the Instagram Business Account where the video will be posted. |
| Video URL | The publicly accessible URL of the video file to upload and post on Instagram. |
| Video Caption | Optional text caption to accompany the video post on Instagram. |
Output
The node outputs JSON data representing the response from the Instagram Graph API after publishing the video post. This typically includes identifiers such as the creation ID of the media object and confirmation of successful publishing.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"id": "12345678901234567"
}
Where id is the identifier of the published media post.
Dependencies
- Requires an API authentication token credential configured in n8n that has permissions to manage Instagram Business Accounts via the Facebook Graph API.
- The Instagram Business Account must be linked to a Facebook Page and properly authorized.
- The video URL must be publicly accessible by the Facebook servers (no private or local URLs).
- The node uses the Facebook Graph API v23.0 endpoint (
https://graph.facebook.com/v23.0).
Troubleshooting
Common issues:
- Invalid or missing Instagram Business Account ID.
- Video URL not accessible or invalid format.
- Insufficient permissions or expired API token.
- API rate limits exceeded.
Error messages:
"Unknown operation": Indicates the operation parameter is incorrect or unsupported."Facebook/Instagram/Threads API Error": General error wrapper for API failures; check the detailed message for specifics like permission errors or invalid parameters.- Network or authentication errors may occur if credentials are misconfigured.
Resolutions:
- Verify the Instagram Business Account ID is correct and linked to your Facebook Page.
- Ensure the video URL is reachable by external services.
- Confirm the API key/token has required scopes and is valid.
- Review Facebook Graph API documentation for any changes or deprecations.