Postiz icon

Postiz

Consume Postiz API

Actions4

Overview

This node integrates with the Postiz API to manage social media posts and related content. It supports creating, scheduling, deleting posts, retrieving posts and integrations, and uploading files. The "Create Post" operation allows users to create posts immediately, as drafts, or scheduled for a future date, including rich content such as text, images, tags, and provider-specific settings.

Typical use cases include automating social media publishing workflows, managing multiple channels or integrations, scheduling posts in advance, and organizing content with tags and groups. For example, a marketing team can schedule promotional posts across various social platforms with customized settings per channel, or upload media files to be attached to posts.

Properties

Name Meaning
Type Type of post to create. Options: Draft, Schedule, Now (immediate posting).
Short Link Boolean flag indicating whether to use short links in the post content.
Date Date and time for the post. Required for scheduling or immediate posts; ignored for drafts.
Tags Array of tags for the post. Each tag has a Value and a Label to categorize or describe the post.
Posts Array of posts to create (required for non-draft types). Each post includes:
- Integration ID: Identifier of the target integration/channel.
- Group: Optional grouping label.
- Settings: Provider-specific key-value pairs.
- Content Items: Array of content pieces, each with:
  - Content text
  - Optional content ID
  - Images array, each image having an ID and path/URL.

Output

The node outputs JSON data representing the response from the Postiz API for the executed operation:

  • For Create Post, it returns the created post details including IDs, status, and metadata.
  • For Get Posts, it returns a list of posts filtered by parameters like week, day, month, year, and customer.
  • For Upload File, it returns information about the uploaded file.
  • For Delete Post, it returns confirmation of deletion.
  • For Get Integrations, it returns a list of connected channels/integrations.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Postiz API.
  • Uses the form-data library internally for file uploads.
  • The node expects proper configuration of the API authentication within n8n credentials.
  • No additional environment variables are explicitly required.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing incomplete or invalid post data (e.g., missing required fields like Integration ID or content) may result in API errors.
    • Scheduling posts with invalid dates or past timestamps might be rejected by the API.
    • Uploading files requires correct binary property names and valid file extensions.

  • Error messages:

    • Errors returned from the API are captured and included in the output under an error field.
    • Typical error descriptions include authorization failures, validation errors on post content, or resource not found for delete operations.

  • Resolution tips:

    • Verify API credentials and permissions.
    • Ensure all required fields are filled correctly according to the operation.
    • Use valid date/time formats and future dates for scheduling.
    • Confirm that binary data properties exist and contain valid file data before uploading.

Links and References

Discussion