Actions21
Overview
This node integrates with the Easy!Appointments API to manage various resources such as appointments, customers, services, providers, and availabilities. Specifically, for the Provider - Get operation, it retrieves detailed information about a single provider by their unique ID. This is useful when you want to fetch provider details like name, contact info, services offered, and additional metadata.
Common scenarios include:
- Fetching provider details to display in a scheduling or booking system.
- Synchronizing provider data between Easy!Appointments and other systems.
- Validating provider existence before creating appointments.
Example: Retrieve a provider's full profile by specifying their Provider ID to show their availability or contact details in your application.
Properties
| Name | Meaning |
|---|---|
| Provider ID | The unique identifier of the provider whose details you want to retrieve. It must be provided as a string. |
Output
The output JSON contains the full provider object as returned by the Easy!Appointments API for the specified Provider ID. This typically includes fields such as:
id: Provider's unique ID.firstName,lastName: Provider's name.email,phone: Contact information.services: List of service IDs the provider offers.- Additional fields like address, city, ZIP, notes, timezone, language, privacy status, and settings (if any).
The node outputs this data as a JSON object under the json key. There is no binary data output for this operation.
Dependencies
- Requires an active connection to the Easy!Appointments API.
- Needs an API authentication credential configured in n8n with the base URL and access token or API key for Easy!Appointments.
- The node uses HTTP requests to interact with the API endpoints.
Troubleshooting
- Invalid Provider ID: If the Provider ID does not exist or is incorrect, the API will likely return an error or empty response. Verify the ID is correct.
- Authentication Errors: Ensure the API credentials are valid and have sufficient permissions to read provider data.
- JSON Parsing Errors: When updating or creating providers, invalid JSON in the "settings" field can cause errors. For the Get operation, this is not applicable.
- Network Issues: Connectivity problems with the Easy!Appointments server will cause request failures.
If an error occurs, the node may throw an error message indicating the problem, such as "Resource not found" or "Unauthorized". Check credentials and input parameters accordingly.
Links and References
- Easy!Appointments API Documentation (general reference for API endpoints)
- n8n Documentation on Creating Custom Nodes