Actions45
- Block Actions
- Block Action Actions
- Booking Actions
- Group Actions
- Offer Actions
- Reservation Actions
- Folio Actions
- Types Actions
Overview
This node integrates with the Apaleo API to manage various hospitality-related resources. Specifically, for the Folio resource with the POST folio operation, it allows users to create a new folio by sending a JSON definition of the folio data. This is useful in scenarios where you want to programmatically add financial records or charges related to a guest's stay.
Practical examples include:
- Automatically generating folios when a guest checks out.
- Adding additional charges or adjustments to an existing booking via folios.
- Integrating with external billing systems to synchronize folio data.
Properties
| Name | Meaning |
|---|---|
| Folio Data | The complete definition of the folio in JSON format. This should include all necessary fields as per Apaleo's folio API specification. |
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 creating the folio. This typically includes details of the created folio such as its ID, status, and any other metadata returned by the API.
If the node supports binary data output (not indicated here), it would represent associated files or attachments related to the folio, but this node focuses on JSON data only.
Dependencies
- Requires an active connection to the Apaleo API.
- Needs an API authentication token (access token) configured in n8n credentials to authorize requests.
- The base URL for API requests is
https://api.apaleo.com. - Proper permissions on the API key to create folios are necessary.
Troubleshooting
Common issues:
- Invalid or incomplete JSON in the "Folio Data" property can cause request failures.
- Missing or expired API access token will result in authentication errors.
- Insufficient permissions on the API key may lead to authorization errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
"Unauthorized"or"Authentication failed": Check that the API token is valid and correctly configured."Bad Request"or validation errors: Verify the JSON structure and required fields in the folio data."Forbidden": Ensure the API key has rights to create folios."Internal Server Error": Retry later or contact Apaleo support if persistent.