Easy!Appointments

Consume Easy!Appointments API

Actions38

Provider → Get Many

AI-generated

Overview

The Easy!Appointments n8n node, when configured with the Provider resource and the Get Many operation, retrieves a list of provider records from an Easy!Appointments API instance. This is useful for automating workflows that need to access or process information about multiple service providers (such as staff members or professionals) registered in your appointment scheduling system.

Common scenarios:

  • Syncing provider data into other systems (e.g., CRM, HR tools).
  • Filtering providers by service, search query, or pagination for reporting.
  • Building dashboards or lists of available providers for further automation.

Example use cases:

  • Fetch all providers offering a specific service for notification or assignment.
  • List all providers for administrative review or export.
  • Paginate through providers to process them in batches.

Properties

Name Type Meaning
Filters Collection A group of optional filters to refine the provider search results.
└ Page Number Page number for paginated results.
└ Length Number Number of results per page.
└ Sort String Sort field and direction (e.g., "id asc").
└ Query String Search query string to filter providers.
└ Service ID String Filter providers by associated service ID.

Output

The output will be a JSON array where each item represents a provider object as returned by the Easy!Appointments API. The structure typically includes fields such as:

{
  "id": 1,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "1234567890",
  "mobile": "0987654321",
  "address": "123 Main St",
  "city": "Sample City",
  "state": "State",
  "zip": "12345",
  "notes": "",
  "timezone": "Europe/Berlin",
  "services": [1,2],
  "workingPlan": { /* ... */ },
  "calendar": { /* ... */ },
  "settings": { /* ... */ }
}

Note: The actual fields depend on your Easy!Appointments API version and configuration.

Dependencies

  • External Service: Requires access to an Easy!Appointments API instance.
  • API Credentials: You must configure the easyAppointmentsApi credential in n8n, including:
    • Base URL (without trailing slash)
    • Username
    • Password

Troubleshooting

Common issues:

  • Missing or incorrect credentials:
    Error message: "Base URL is required" or authentication errors.
    Resolution: Ensure the Easy!Appointments API credentials are correctly set up in n8n.

  • Invalid filter values:
    Error message: API returns validation or bad request errors.
    Resolution: Double-check filter values (e.g., valid service IDs, correct sort syntax).

  • No results returned:
    Possible cause: Filters too restrictive or no matching providers.
    Resolution: Broaden your filters or check if providers exist in the system.

  • API unreachable:
    Error message: Network or connection errors.
    Resolution: Verify the API URL and network connectivity.

Links and References

Discussion