Overview
This node integrates with the Postiz API to manage social media posts and related content. The "Create Post" operation allows users to create new posts in various states: as drafts, scheduled for a future date/time, or published immediately. This is useful for automating social media workflows such as preparing content ahead of time, managing multiple channels, or posting instantly.
Practical examples include:
- Scheduling marketing posts across multiple social media channels.
- Creating draft posts for review before publishing.
- Publishing breaking news or updates immediately.
- Adding tags and rich content (text, images) to posts programmatically.
Properties
| Name | Meaning |
|---|---|
| Type | Type of post to create. Options: Draft (save as draft), Schedule (post at specified date/time), Now (post immediately). |
| Short Link | Whether to use short links in the post content (true or false). |
| Date | Date and time for the post. Required for scheduling or immediate posting; ignored for drafts. |
| Tags | Tags associated with the post. Each tag has a Value and a Label. |
| Posts | Array of posts to create (required for non-draft types). Each post includes: - Channel ID: Identifier of the channel where the post will be published. - Group: Optional grouping label. - Settings: Provider-specific key-value settings with typed values (string, number, boolean, JSON). - Content Items: Array of content blocks, each with text content, optional ID, and optional images (each image has an ID and path/URL). |
Output
The node outputs a JSON array representing the response from the Postiz API for the created post(s). The structure depends on the API response but generally includes details about the created posts such as IDs, status, timestamps, and any metadata returned by the service.
If the operation involves uploading files or generating videos, the output contains relevant information about the uploaded file or generated video.
No binary data output is produced by the "Create Post" operation.
Dependencies
- Requires an API key credential for authenticating with the Postiz API.
- Uses the Postiz REST API endpoints to perform operations.
- For file uploads, uses multipart form data.
- The node expects proper configuration of credentials within n8n to authorize API requests.
Troubleshooting
- Missing or invalid API credentials: Ensure that the API key credential is correctly configured and valid.
- Invalid or missing required parameters: For example, when creating a scheduled or immediate post, the
dateandpostsproperties must be provided and correctly formatted. - Malformed JSON in settings: When specifying provider-specific settings with JSON type, ensure the JSON is valid; otherwise, parsing errors may occur.
- Empty or incorrect channel IDs: The
Channel IDmust correspond to a valid connected channel; otherwise, the API will reject the request. - Binary property issues during file upload: If using the upload file operation, the binary property must contain valid data with expected fields (
data,mimeType,fileName). - API rate limits or network errors: Handle these by enabling "Continue On Fail" in the node settings to avoid workflow interruption.
Common error messages typically relate to validation failures or authentication errors and can be resolved by verifying input parameters and credentials.