Nookal icon

Nookal

Interact with Nookal practice management system via GraphQL API
Join our community

Actions14

Overview

This node integrates with the Nookal practice management system via its GraphQL API, allowing users to manage healthcare-related data such as patients, appointments, practitioners, and locations. Specifically, the Appointment - Get All operation retrieves a list of appointments from the Nookal system.

Common scenarios for this node include:

  • Fetching upcoming or past appointments for reporting or synchronization with other systems.
  • Automating workflows that require appointment data, such as sending reminders or updating calendars.
  • Integrating appointment data into custom dashboards or analytics tools.

For example, a clinic could use this node to pull all appointments scheduled for the day and then trigger reminder emails to patients automatically.

Properties

Name Meaning
Limit Max number of appointment results to return (minimum 1, maximum 100). Defaults to 50.

Output

The output is a JSON array where each item represents an appointment with the following structure:

  • id: Unique identifier of the appointment.
  • startTime: Start time of the appointment (ISO 8601 datetime string).
  • endTime: End time of the appointment (ISO 8601 datetime string).
  • type: Type/category of the appointment.
  • status: Current status of the appointment (e.g., confirmed, cancelled).
  • notes: Any notes associated with the appointment.
  • patient: Object containing patient details:
    • id
    • firstName
    • lastName
  • practitioner: Object containing practitioner details:
    • id
    • firstName
    • lastName
  • location: Object containing location details:
    • id
    • name
  • createdAt: Timestamp when the appointment was created.
  • updatedAt: Timestamp when the appointment was last updated.

The node does not output binary data.

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the Nookal GraphQL API.
  • The node depends on the external Nookal practice management system being accessible and the API credentials having sufficient permissions to read appointment data.

Troubleshooting

  • Invalid JSON in variables field: If using the Custom Query resource, ensure that any JSON provided in the "Variables" property is valid JSON syntax.
  • Unknown operation errors: Selecting an unsupported operation for the Appointment resource will throw an error. Verify that "Get All" is selected for fetching multiple appointments.
  • API authentication errors: Ensure that the API key or OAuth2 credentials are correctly set up and have not expired.
  • Limit out of range: The "Limit" property must be between 1 and 100; values outside this range may cause errors or unexpected behavior.
  • Network or API downtime: Connectivity issues with the Nookal API will result in request failures. Check network connectivity and Nookal service status.

Links and References

Discussion