ServiceM8 icon

ServiceM8

ServiceM8 Node

Job → Get Many

AI-generated

Overview

This node integrates with the ServiceM8 platform, focusing on managing "Job" resources. Specifically, the "Get Many" operation retrieves multiple job records from ServiceM8 based on user-defined filters. This is useful for scenarios where you need to fetch a list of jobs matching certain criteria, such as jobs created after a specific date, jobs assigned to a particular employee, or jobs with a certain status.

Practical examples include:

  • Fetching all open jobs for a given client.
  • Retrieving jobs scheduled within a date range.
  • Extracting jobs filtered by custom fields for reporting or automation workflows.

Properties

Name Meaning
Filters A collection of filter conditions to narrow down the jobs retrieved. Each filter includes:
- Field Name or ID: The job field to filter by (selectable from available job fields).
- Operator: The comparison operator to apply. Options are Equal To, Not Equal, Greater Than, and Less Than.
- Value: The value to compare the field against.

Filters can be combined with multiple conditions to refine the query.

Output

The output is an array of JSON objects, each representing a job record retrieved from ServiceM8. Each object contains the job's data fields as returned by the ServiceM8 API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the ServiceM8 API.
  • The node uses the ServiceM8 REST API endpoints to fetch job data.
  • No additional environment variables are required beyond the API authentication setup in n8n.

Troubleshooting

  • No results returned: Ensure that the filter conditions are correctly specified and match existing job data. Incorrect field names or values may result in empty responses.
  • Invalid filter field: If a filter field does not exist or is misspelled, the API may return an error or no data. Use the provided options list to select valid fields.
  • API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Rate limiting or network issues: Temporary failures may occur due to API rate limits or connectivity problems. Retry or check network settings if errors persist.
  • Error message "No search query was provided": This applies to search operations, not "Get Many". For "Get Many", ensure filters are properly set.

Links and References

Discussion