Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node integrates with the Apaleo API to manage hotel booking-related data. Specifically, for the Booking resource and the POST bookings operation, it allows users to create new bookings by sending detailed booking information in JSON format. This is useful in scenarios where automated or bulk creation of bookings is needed, such as integrating a custom booking system, syncing reservations from other platforms, or automating booking workflows.

Practical examples include:

  • Automatically creating bookings when a customer completes a reservation on an external website.
  • Importing bookings from third-party systems into Apaleo.
  • Automating booking creation as part of a larger workflow involving guest management or payment processing.

Properties

Name Meaning
Booking Details The booking details provided as a JSON object. This should contain all necessary fields required by the Apaleo API to create a booking.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON object contains the response from the Apaleo API after attempting to create a booking. This typically includes details of the created booking such as booking ID, status, guest information, and any metadata returned by the API.

If the node encounters errors during execution and "Continue On Fail" is enabled, the output will include error messages alongside empty JSON objects for failed items.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Apaleo API via an API authentication token (access token).
  • The user must configure the node with valid credentials that provide access to the Apaleo API.
  • Network connectivity to https://api.apaleo.com is necessary.

Troubleshooting

  • Common issues:

    • Invalid or incomplete booking details JSON can cause the API to reject the request.
    • Expired or invalid API tokens will result in authentication errors.
    • Network issues or incorrect base URL configuration may prevent successful API calls.
  • Error messages:

    • Authentication errors typically indicate problems with the API token; refreshing or reconfiguring credentials resolves these.
    • Validation errors from the API usually specify which booking details are missing or malformed; ensure the JSON matches the expected schema.
    • Rate limiting or server errors from Apaleo require retrying after some time or contacting Apaleo support.

Links and References

Discussion