Postiz icon

Postiz

Consume Postiz API

Actions4

Overview

This node integrates with the Postiz API, enabling users to manage social media posts and upload files. Specifically, the Upload File operation allows uploading a binary file to the Postiz platform by providing the file data and its extension.

Common scenarios for this node include automating content publishing workflows where files (images, videos, etc.) need to be uploaded to Postiz before being attached to posts or shared on connected channels. For example, a marketing team could automate uploading promotional images or videos as part of their scheduled social media campaigns.

Properties

Name Meaning
Binary Property The name of the binary property in the input data that contains the file's raw data.
Extension The file extension/type of the file being uploaded (e.g., png, jpg, mp4).

Output

The node outputs JSON data representing the response from the Postiz API after uploading the file. This typically includes metadata about the uploaded file such as its ID, URL, or status.

If the file upload is successful, the output JSON will contain details confirming the upload. In case of an error, the output JSON will contain an error field describing the issue.

The node does not output binary data itself; it only sends binary data as input and returns JSON metadata about the uploaded file.

Dependencies

  • Requires an active connection to the Postiz API via an API key credential.
  • The node uses the form-data library internally to format the file upload request.
  • The user must provide valid binary data in the specified binary property.
  • Proper configuration of the Postiz API credentials within n8n is necessary.

Troubleshooting

  • Common issues:

    • Providing an incorrect or empty binary property name will cause the upload to fail because no file data will be found.
    • Incorrect file extension may lead to unsupported file type errors from the API.
    • Network or authentication errors if the API key is invalid or missing.

  • Error messages:

    • Errors returned from the Postiz API are captured and returned in the output JSON under an error field.
    • If the node logs an error related to "file data," verify that the binary property exists and contains valid base64-encoded data.
    • Authentication errors indicate problems with the API key credential setup.

Links and References

Discussion