Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node interacts with the Apaleo API to perform various operations related to hotel management resources. Specifically, for the "Block Action" resource and the "PUT release block" operation, it allows users to release a previously held block in the booking system. This is useful in scenarios where a block of rooms or inventory was reserved temporarily but now needs to be freed up for other bookings.

Practical examples include:

  • Releasing a block of rooms that were held for a group but are no longer needed.
  • Managing room availability dynamically by releasing blocks when plans change.
  • Automating inventory control workflows in hotel property management systems.

Properties

Name Meaning
Block ID The unique identifier of the block to perform the release action on.

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 release the specified block. The structure typically includes confirmation details about the released block or error information if the operation failed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Apaleo API.
  • Needs an API authentication token (access token) configured in the node credentials.
  • The base URL for API requests is https://api.apaleo.com.
  • Proper permissions on the API key to perform block actions such as releasing blocks.

Troubleshooting

  • Common issues:

    • Invalid or expired API token leading to authentication errors.
    • Providing a non-existent or incorrect Block ID causing "not found" errors.
    • Insufficient permissions on the API key to perform block release operations.
  • Error messages:

    • "Unauthorized": Check that the API token is valid and has not expired.
    • "Block not found": Verify the Block ID is correct and exists in the system.
    • "Forbidden" or permission-related errors: Ensure the API key has rights to modify blocks.
  • To resolve these, verify credentials, confirm Block IDs, and check API user permissions.

Links and References

Discussion