Nookal icon

Nookal

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

Actions14

Overview

The node integrates with the Nookal practice management system via its GraphQL API, specifically enabling operations on various resources such as patients, appointments, practitioners, and locations. For the Patient - Create operation, this node allows users to create a new patient record in the Nookal system by providing relevant patient details.

This is beneficial in healthcare automation workflows where new patient data needs to be programmatically added to the practice management system, for example:

  • Automatically creating patient profiles from online appointment booking forms.
  • Syncing patient data from other systems or CRMs into Nookal.
  • Bulk importing patient records during migrations or integrations.

Properties

Name Meaning
Patient Data A collection of fields describing the patient to create. Includes:
- First Name (string)
- Last Name (string)
- Email (string)
- Phone (string)
- Date of Birth (dateTime)
- Gender (options): Male, Female, Other

These fields correspond to the patient's personal information required to create a new patient record in Nookal.

Output

The output JSON contains the result of the create patient mutation, structured as follows:

{
  "createPatient": {
    "patient": {
      "id": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "phone": "string",
      "dateOfBirth": "string (ISO date-time)",
      "gender": "string",
      "createdAt": "string (ISO date-time)",
      "updatedAt": "string (ISO date-time)"
    },
    "errors": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}
  • The patient object contains the newly created patient's details including their unique ID and timestamps.
  • The errors array lists any validation or processing errors encountered during creation, specifying the field and error message.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests to the Nookal GraphQL API.
  • The node depends on the internal helper function to send GraphQL requests to Nookal's API endpoint.
  • Proper network access to Nookal's API service is necessary.

Troubleshooting

  • Invalid Input Errors: If required patient fields are missing or invalid (e.g., malformed email), the API may return errors in the errors array. Review these messages to correct input data.
  • Authentication Failures: Ensure the OAuth2 credentials are correctly set up and have not expired.
  • JSON Parsing Issues: The node expects valid JSON structures for inputs; malformed JSON in properties like variables (for custom queries) will cause errors.
  • API Rate Limits or Network Issues: Temporary failures communicating with Nookal's API can occur; retry or check connectivity.
  • Unknown Operation Error: If an unsupported operation is selected, the node throws an error indicating the unknown operation.

Links and References

Discussion