Actions21
Overview
This node integrates with the Easy!Appointments API to manage providers and other related resources such as appointments, customers, and services. Specifically, for the Provider - Create operation, it allows users to create a new provider record in the Easy!Appointments system by specifying details like name, contact information, services offered, and additional optional fields.
Common scenarios where this node is beneficial include:
- Automating the onboarding of new service providers into an appointment scheduling system.
- Synchronizing provider data from external HR or CRM systems into Easy!Appointments.
- Bulk creation of providers during initial setup or migration processes.
For example, you can use this node to create a new healthcare provider with their contact details, list of services they offer, timezone, language preferences, and custom settings such as notification preferences.
Properties
| Name | Meaning |
|---|---|
| First Name | The first name of the provider. |
| Last Name | The last name of the provider. |
| The email address of the provider. | |
| Phone | The phone number of the provider. |
| Services | Comma-separated list of service IDs that the provider can provide (e.g., "1, 2, 3"). |
| Additional Fields | A collection of optional fields: |
| - Address | The address of the provider. |
| - City | The city where the provider is located. |
| - ZIP | The ZIP code of the provider's location. |
| - Notes | Any notes about the provider. |
| - Timezone | The timezone of the provider (default is "UTC"). |
| - Language | The language preference of the provider (default is "english"). |
| - Is Private | Boolean indicating whether the provider is private. |
| - Settings | JSON object containing provider-specific settings such as username, password, notifications. |
Output
The node outputs JSON data representing the created provider resource as returned by the Easy!Appointments API. This typically includes all the provider's details such as their ID, name, contact info, services, and any additional fields set during creation.
If multiple items are processed, the output will be an array of such JSON objects, each corresponding to one created provider.
The node does not output binary data.
Dependencies
- Requires an active connection to the Easy!Appointments API.
- Needs an API authentication token or key configured in the node credentials to authorize requests.
- The base URL of the Easy!Appointments instance must be provided in the credentials configuration.
Troubleshooting
- Invalid settings JSON error: If the "Settings" field contains malformed JSON, the node will throw an error indicating invalid JSON. To fix this, ensure the JSON string is correctly formatted.
- API authentication errors: If the API key or token is missing or incorrect, the node will fail to authenticate. Verify the credentials configuration.
- Service IDs parsing: The "Services" property expects a comma-separated string of numeric IDs. Non-numeric or improperly formatted values may cause errors.
- Required fields missing: Ensure mandatory fields like first name and last name are provided; otherwise, the API may reject the request.
Links and References
- Easy!Appointments Official Website
- Easy!Appointments API Documentation (Assumed typical location; verify actual docs)