Postiz icon

Postiz

Consume Postiz API

Actions6

Overview

This node integrates with the Postiz API, enabling users to perform various operations related to social media post management and video generation. The "Upload File" operation specifically allows uploading a binary file to the Postiz platform. This is useful when you want to attach media files (images, videos, documents) to posts or other content managed via Postiz.

Practical scenarios include:

  • Uploading images or videos to be used in scheduled social media posts.
  • Sending files to Postiz for further processing or storage.
  • Automating media uploads as part of a larger workflow involving content creation and publishing.

Properties

Name Meaning
Binary Property Name of the binary property that contains the file data to upload. This must reference a binary input item containing the file's data, MIME type, and filename.

Output

The node outputs JSON data representing the response from the Postiz API after uploading the file. Typically, this will include metadata about the uploaded file such as its ID, URL, or status confirmation.

If the node handles binary data, it expects the input binary property to contain:

  • data: Base64 encoded file content.
  • mimeType: MIME type of the file.
  • fileName: Original filename.

The output does not include binary data but rather the API's JSON response confirming the upload.

Dependencies

  • Requires an active connection to the Postiz API using an API key credential configured in n8n.
  • Uses the postizApiRequest helper function to make authenticated HTTP requests to Postiz endpoints.
  • Relies on the input containing valid binary data under the specified binary property.

Troubleshooting

  • Error: Item is not of type "binary" or does not contain the expected properties: data, mimeType, fileName
    This error occurs if the specified binary property is missing or malformed. Ensure the input item has a binary property with these exact fields properly set.

  • API request failures
    If the upload fails due to authentication or network issues, verify that the API key credential is correctly configured and that the Postiz service is reachable.

  • Incorrect binary property name
    Double-check that the "Binary Property" parameter matches the actual binary property name in the incoming data.

Links and References

Discussion