Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node integrates with the Apaleo API to manage group bookings. Specifically, the PATCH group operation allows users to update an existing group booking by applying a set of changes described in JSON Patch format. This is useful for scenarios where you need to modify details of a group reservation dynamically, such as updating guest information, changing booking parameters, or adjusting group attributes without replacing the entire group data.

Practical examples include:

  • Modifying the number of guests in a group booking.
  • Updating contact details or special requests for the group.
  • Adjusting dates or other booking-related properties incrementally.

Properties

Name Meaning
Group ID The unique identifier of the group booking to be updated.
Operations A JSON Patch formatted array describing the operations (add, remove, replace, etc.) to perform on the group booking.

Output

The node outputs an array of JSON objects representing the results of the PATCH operation on the group booking. Each output item corresponds to one input item processed and contains the updated group booking data after applying the patch operations.

If the node supports binary data output, it is not indicated here; the output focuses on JSON responses from the Apaleo API reflecting the updated group state.

Dependencies

  • Requires an API authentication token credential for Apaleo API access.
  • The node communicates with the Apaleo API endpoint at https://api.apaleo.com.
  • Proper configuration of the API key/credential within n8n is necessary for successful requests.

Troubleshooting

  • Common issues:

    • Invalid or malformed JSON Patch operations can cause the API to reject the request.
    • Providing an incorrect or non-existent Group ID will result in errors indicating the group was not found.
    • Authentication failures if the API token is missing, expired, or invalid.
  • Error messages and resolutions:

    • "Group not found" β€” Verify the Group ID is correct and exists in Apaleo.
    • "Invalid JSON Patch format" β€” Ensure the operations property is a valid JSON Patch array following RFC 6902 standards.
    • Authentication errors β€” Check that the API credentials are correctly configured and have not expired.
  • Enabling "Continue On Fail" in the node settings can help process multiple items even if some fail.

Links and References

Discussion