Overview
This node allows users to interact with the Jobber API by sending custom GraphQL queries or mutations. It is useful for scenarios where you want to retrieve, create, update, or delete data in Jobber using flexible GraphQL operations rather than predefined REST endpoints. For example, you could query client details, fetch job information, or perform mutations to update records directly through this node.
Properties
| Name | Meaning |
|---|---|
| Graphql Query | The GraphQL query or mutation string to send to the Jobber API. Use either a query or mutation. |
Output
The node outputs an array of JSON objects under the json field. Each object corresponds to the data field returned from the Jobber GraphQL API response for each input item processed. This typically contains the result of the executed GraphQL query or mutation.
No binary data output is produced by this node.
Dependencies
- Requires an OAuth2 API credential configured for authenticating with the Jobber API.
- The node sends POST requests to
https://api.getjobber.com/api/graphql. - The request includes specific headers such as
X-JOBBER-GRAPHQL-VERSIONset to"2023-11-15".
Troubleshooting
Common issues:
- Invalid or malformed GraphQL queries/mutations will cause errors.
- Authentication failures if the OAuth2 credentials are not properly set up or expired.
- Network or connectivity issues reaching the Jobber API endpoint.
Error messages:
- Errors thrown by the Jobber API will be surfaced and can include validation errors for the GraphQL query.
- If
continueOnFailis enabled, failed items will include anerrorproperty describing the failure. - Without
continueOnFail, the node will stop execution and throw an error indicating which item caused the failure.
Resolution tips:
- Verify the syntax and structure of your GraphQL query or mutation.
- Ensure your OAuth2 credentials are valid and have necessary permissions.
- Check network connectivity and API availability.