Actions14
Overview
The node enables executing custom GraphQL queries against the Nookal practice management system API. This allows users to retrieve or manipulate data flexibly beyond predefined operations by specifying any valid GraphQL query and optional variables.
Common scenarios include:
- Fetching specific or complex patient, appointment, practitioner, or location data not covered by standard operations.
- Running aggregated or filtered queries tailored to unique business needs.
- Testing new GraphQL queries before integrating them into workflows.
For example, a user might execute a query to fetch the first 10 patients with their contact details or run a mutation to update multiple records in one request.
Properties
| Name | Meaning |
|---|---|
| GraphQL Query | The GraphQL query string to execute. Can be any valid query or mutation for Nookal API. |
| Variables | JSON object of variables to pass to the GraphQL query, allowing dynamic parameterization. |
Output
The output is a JSON array containing the result of the executed GraphQL query. The structure depends entirely on the query provided by the user. It typically includes data fields requested in the query or errors if the query failed.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Nookal API via OAuth2 authentication (an API key credential).
- The node uses a helper function to send GraphQL requests to the Nookal API endpoint.
- Proper configuration of the OAuth2 credentials in n8n is necessary for successful API communication.
Troubleshooting
- Invalid JSON in Variables: If the "Variables" input contains malformed JSON, the node throws an error indicating invalid JSON. Ensure the JSON syntax is correct.
- GraphQL Errors: Errors returned from the API (e.g., syntax errors in the query, unauthorized access) will appear in the output. Review the query and credentials.
- Authentication Issues: Failure to authenticate with the API will prevent query execution. Verify that the OAuth2 credentials are correctly set up and have sufficient permissions.
- Empty or Unexpected Results: If the query returns no data or unexpected fields, double-check the query syntax and requested fields.
Links and References
- Nookal API Documentation (for GraphQL schema and examples)
- GraphQL Official Documentation (to understand query structure and variables)