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. It allows users to perform various operations on different resources such as Patients, Appointments, Practitioners, Locations, and execute custom GraphQL queries.

Specifically for the Practitioner - Get operation, the node fetches detailed information about a single practitioner by their unique ID. This is useful in scenarios where you need to retrieve practitioner details like contact info, specialties, and associated locations within automated workflows.

Practical examples:

  • Automatically fetching practitioner details when scheduling appointments.
  • Syncing practitioner data into other systems or CRMs.
  • Displaying practitioner profiles in patient-facing applications.

Properties

Name Meaning
ID The unique identifier of the practitioner resource to retrieve. This is a required string input.

Output

The output JSON contains detailed information about the requested practitioner, including:

  • id: Unique identifier of the practitioner.
  • firstName: Practitioner’s first name.
  • lastName: Practitioner’s last name.
  • email: Contact email address.
  • phone: Contact phone number.
  • specialties: Array of specialties or areas of expertise.
  • locations: Array of location objects where the practitioner works, each containing:
    • id: Location ID.
    • name: Location name.
  • createdAt: Timestamp when the practitioner record was created.
  • updatedAt: Timestamp of the last update to the practitioner record.

The output is structured as a JSON object representing the practitioner data fetched from the Nookal API.

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests to the Nookal GraphQL API.
  • Network access to the Nookal API endpoint.
  • The node depends on internal helper functions to send GraphQL queries and handle responses.

Troubleshooting

  • Invalid or missing ID: If the provided practitioner ID is invalid or not found, the API may return an error or empty result. Ensure the ID is correct.
  • Authentication errors: If the OAuth2 credentials are misconfigured or expired, authentication will fail. Reconfigure or refresh the API credentials.
  • API rate limits or downtime: Temporary API unavailability or rate limiting can cause errors. Retry after some time or check Nookal service status.
  • Malformed response or network issues: Network interruptions or unexpected API responses can cause failures. Verify connectivity and API stability.

Common error messages:

  • "Unknown practitioner operation": Indicates an unsupported operation was requested; ensure only supported operations like "get" or "getAll" are used.
  • "Invalid JSON in variables field": Relevant for custom queries if JSON variables are malformed.

Links and References

Discussion