HWP to PDF icon

HWP to PDF

Upload HWP file and receive PDF
Join our community

Overview

This node converts HWP (Hangul Word Processor) files to PDF format by uploading the binary HWP file to an external API and receiving the converted PDF in response. It is useful when you need to automate document conversions within your workflow, such as preparing reports or sharing documents in a more accessible PDF format.

Typical use cases include:

  • Automating batch conversion of HWP files stored in your system.
  • Integrating HWP to PDF conversion into document processing pipelines.
  • Converting user-uploaded HWP files to PDFs for preview or archival.

Properties

Name Meaning
Binary Property Name of the binary property that contains the input HWP file to be converted.
PDF Filename Desired filename for the resulting PDF output (without the .pdf extension).
API Endpoint URL of the external API endpoint used to perform the HWP to PDF conversion.
Timeout (seconds) Maximum time in seconds to wait for the API request before timing out.

Output

The node outputs JSON data with a binary field containing the converted PDF file:

  • json: An empty object {} since no additional JSON data is returned.
  • binary: Contains one property named after the input binary property, holding the PDF file data.
    • The PDF binary data includes the filename set to the specified PDF filename with .pdf extension.
    • The MIME type is set to application/pdf.

If the conversion fails and "Continue On Fail" is enabled, the output will contain an error message in the JSON field instead.

Dependencies

  • Requires access to an external HTTP API capable of converting HWP files to PDF.
  • Needs an internet connection and proper configuration of the API endpoint URL.
  • No internal credentials are required by default, but if the API requires authentication, appropriate credentials must be configured externally.
  • The node uses n8n helper methods to handle binary data and HTTP requests.

Troubleshooting

  • No binary data found for property: Ensure the specified binary property name matches the actual binary input property containing the HWP file.
  • Invalid response from API: The API did not return a valid PDF buffer. Check the API endpoint and ensure it supports the expected request format.
  • API Error: [status] - [statusText]: The external API responded with an error status. Verify API availability, credentials, and request parameters.
  • Request timed out after X seconds: Increase the timeout setting if the API takes longer to process large files.
  • Request failed: [message]: General network or request failure; check connectivity and API endpoint correctness.

Links and References

Discussion