Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node integrates with the Hudu REST API to manage company records within the Hudu system. Specifically, the "Company - Create" operation allows users to create a new company entry by providing essential details such as the company's name and optional additional information like address, contact details, and company type.

Common scenarios for this node include automating the onboarding of new companies into Hudu from other systems, synchronizing company data across platforms, or bulk-creating company records based on external data sources.

For example, a user might use this node to automatically add a newly signed client’s company details into Hudu after a contract is finalized in a CRM system.

Properties

Name Meaning
Name The name of the company (required).
Additional Fields Optional extra fields to provide more detailed company information:
- Address Line 1 The first line of the company's address.
- Address Line 2 The second line of the company's address.
- City The city where the company is located.
- Company Type The type/category of the company.
- Country Name The country where the company is located.
- Fax Number The company's fax number.
- ID Number The company's identification number.
- Nickname A nickname for the company.
- Notes Additional notes about the company.
- Parent Company Name or ID Reference to a parent company, selectable from existing companies or specified via expression.
- Phone Number The company's phone number.
- State The state where the company is located.
- Website The company's website URL.
- ZIP The zip/postal code of the company's location.

Output

The node outputs an array of JSON objects representing the created company record(s) as returned by the Hudu API. Each output item corresponds to one input item processed.

The json output field contains the full response data from the API about the newly created company, including all fields sent and any additional metadata assigned by Hudu.

This node does not output binary data.

Dependencies

  • Requires an active connection to the Hudu REST API.
  • Needs an API key credential configured in n8n for authentication.
  • The base URL for the Hudu API must be set in the node credentials.
  • The node relies on internal helper methods to handle API requests and responses.

Troubleshooting

  • Common issues:

    • Missing required "Name" property will cause the API call to fail.
    • Invalid or expired API key will result in authentication errors.
    • Providing invalid values for fields like "Parent Company" may cause lookup failures.
    • Network connectivity problems can prevent successful API communication.
  • Error messages:

    • "The resource "companies" is not known!": This indicates an incorrect resource parameter; ensure "companies" is selected.
    • API errors related to validation will typically return descriptive messages from Hudu, e.g., missing required fields or invalid formats.
  • Resolutions:

    • Verify that all required fields are provided.
    • Check API key validity and permissions.
    • Use expressions carefully when specifying dynamic values.
    • Ensure network access to the Hudu API endpoint.

Links and References

Discussion