Actions12
Overview
The Bookla node integrates with the Bookla API to retrieve and manage booking-related data. Specifically, the Client - Search operation allows users to search for clients within a specified company on the Bookla platform. This operation supports searching by client ID, email address, or an external user ID from your own system.
This node is beneficial in scenarios where you need to synchronize client information between Bookla and other systems, verify client existence before creating bookings, or filter clients based on identifiers for further processing.
Example use cases:
- Searching for a client by their email to retrieve their profile before making a booking.
- Looking up clients by an external user ID to link Bookla data with your internal CRM.
- Validating if a client ID exists in Bookla before updating client details.
Properties
| Name | Meaning |
|---|---|
| Server | Select which Bookla server to connect to. Options: US Server, EU Server |
| Company ID | The unique identifier of the company in Bookla under which the client search will be performed (required) |
| Client ID | Search for clients by their Bookla client ID |
| Search for clients by their email address | |
| External User ID | Search for clients by an external user ID used in your own system |
Output
The output of this operation is JSON data representing the list of clients matching the search criteria. The structure typically includes client details such as IDs, names, contact information, and any other metadata provided by the Bookla API.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Bookla API.
- The node must be configured with the correct server region (US or EU) to target the appropriate Bookla endpoint.
- Requires the
company_idparameter to specify the scope of the client search.
Troubleshooting
- Empty results: If no clients are returned, verify that the search parameters (clientID, email, externalUserID) are correctly set and correspond to existing clients in the specified company.
- Authentication errors: Ensure that the API key credential is valid and has sufficient permissions to access client data.
- Invalid company ID: Confirm that the
company_idis correct and that the authenticated user has access to it. - Server selection: Make sure the selected server (US or EU) matches the region where your Bookla account is hosted.
Links and References
- Bookla API Documentation (hypothetical link for reference)
- n8n documentation on HTTP Request Node for understanding API integrations