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, specifically enabling the creation of appointments. It allows users to schedule new appointments by specifying details such as patient, practitioner, location, timing, and additional notes.

Common scenarios where this node is beneficial include:

  • Automating appointment scheduling workflows in healthcare or wellness practices.
  • Integrating booking systems with other applications like CRM or calendar tools.
  • Streamlining patient management by programmatically creating appointments based on external triggers.

For example, a clinic could use this node to automatically create follow-up appointments for patients after consultations, ensuring seamless scheduling without manual entry.

Properties

Name Meaning
Patient ID The unique identifier of the patient for whom the appointment is being created (required).
Practitioner ID The unique identifier of the practitioner who will attend the appointment (required).
Location ID The unique identifier of the location where the appointment will take place (required).
Start Time The starting date and time of the appointment (required).
End Time The ending date and time of the appointment (required).
Type The type or category of the appointment (optional).
Notes Additional notes or comments related to the appointment (optional).

Output

The output JSON contains detailed information about the newly created appointment, including:

  • id: Unique identifier of the appointment.
  • startTime and endTime: Scheduled start and end times.
  • type: Appointment type.
  • status: Current status of the appointment.
  • notes: Any notes associated with the appointment.
  • Nested objects for:
    • patient: Basic patient info (id, firstName, lastName).
    • practitioner: Basic practitioner info (id, firstName, lastName).
    • location: Location info (id, name).
  • createdAt: Timestamp when the appointment was created.
  • errors: If any errors occurred during creation, includes fields and messages describing them.

The node does not output binary data.

Dependencies

  • Requires an API authentication token configured in n8n credentials to access the Nookal GraphQL API.
  • Relies on the Nookal practice management system being accessible and properly configured to accept API requests.
  • No additional external dependencies beyond standard n8n environment and the provided credential.

Troubleshooting

  • Missing Required Fields: Errors may occur if required fields like Patient ID, Practitioner ID, Location ID, Start Time, or End Time are missing or invalid. Ensure all required inputs are correctly provided.
  • Invalid Date/Time Format: Start and End times must be valid datetime values; incorrect formats can cause API errors.
  • API Authentication Issues: Failure to authenticate with the Nookal API will result in authorization errors. Verify that the API key or OAuth2 token is correctly set up in n8n credentials.
  • Error Messages in Output: The response may include an errors array detailing field-specific issues. Review these messages to correct input data.
  • Network or API Downtime: Connectivity problems or Nookal service outages will cause request failures. Check network connectivity and Nookal service status.

Links and References

Discussion