ApaleoInstall

Overview

This node integrates with the Apaleo API, specifically allowing users to manage groups within the Apaleo booking system. The "POST group" operation enables creating a new group by sending group data in JSON format. This is useful for scenarios where you want to programmatically organize multiple bookings or reservations under a single group entity, such as corporate bookings, event attendees, or family packages.

Practical examples include:

• Creating a group for a conference attendee list.
• Organizing multiple related bookings under one group for easier management and billing.
• Automating group creation when importing bulk reservation data from external systems.

Properties

Output

The node outputs an array of JSON objects corresponding to each input item processed. For the "POST group" operation, the output JSON will contain the response from the Apaleo API after attempting to create the group. This typically includes details of the newly created group such as its unique identifier, name, and other metadata returned by the API.

If any errors occur during execution and the node is configured to continue on failure, 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.
• Needs an API authentication token (access token) configured in the node credentials to authorize requests.
• The base URL for API requests is https://api.apaleo.com.
• Proper permissions on the API key to perform group creation operations.

Troubleshooting

• Common issues:

  • Invalid or malformed JSON in the "Group 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 group data.
  • "Forbidden": Ensure the API key has the necessary rights to create groups.
  • Timeout or network errors: Confirm network access to api.apaleo.com.

Resolving these usually involves verifying credentials, correcting the JSON payload, and ensuring network connectivity.

Links and References

• Apaleo API Documentation
• Apaleo Group Management API
• n8n documentation on Using Credentials