Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node integrates with the Apaleo API to manage reservations and related booking data. Specifically, for the "Reservation" resource and the "GET reservation offers" operation, it retrieves available offers associated with a particular reservation ID. This is useful in scenarios where you want to fetch all offer options linked to an existing reservation, such as displaying upgrade options or alternative pricing plans to customers.

Practical examples include:

  • Fetching all current offers tied to a guest's reservation to present them during check-in.
  • Retrieving promotional or package offers applicable to a specific booking for marketing or upselling purposes.

Properties

Name Meaning
Reservation ID The unique identifier of the reservation for which to retrieve associated offers.

Output

The node outputs JSON data representing the list of offers related to the specified reservation. Each item in the output typically contains details about an individual offer, such as offer name, description, pricing, validity, and other relevant metadata provided by the Apaleo API.

If the node supports binary data output (not indicated here), it would typically represent attachments or documents related to offers, but this operation primarily returns structured JSON data.

Dependencies

  • Requires an API key credential for authenticating with the Apaleo API.
  • The node uses the base URL https://api.apaleo.com for all requests.
  • Proper configuration of the API authentication token is necessary within n8n credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Reservation ID will cause the API call to fail.
    • Expired or incorrect API authentication token will result in authorization errors.
    • Network connectivity problems can prevent successful API communication.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly configured and valid.
    • "Reservation not found": Verify that the provided Reservation ID exists and is correct.
    • "Request failed" or timeout errors: Ensure network access to the Apaleo API endpoint is available.

Resolving these usually involves verifying input parameters, refreshing API credentials, and checking network settings.

Links and References

Discussion