ServiceM8 icon

ServiceM8

ServiceM8 Node
Join our community

Actions11

Overview

This node integrates with the ServiceM8 platform to manage jobs, clients, emails, and SMS messages. Specifically, the Job - Create From Template operation allows users to create a new job based on an existing job template in ServiceM8. This is useful for automating job creation when you have predefined templates that standardize job details, saving time and ensuring consistency.

Typical use cases include:

  • Automatically creating service jobs from templates when a new client request arrives.
  • Standardizing job creation with preset descriptions, addresses, and company information.
  • Integrating job creation into broader workflows such as CRM or scheduling systems.

For example, a field service company could use this node to generate a new job for a technician using a template whenever a customer books a service online.

Properties

Name Meaning
Job Template ID Or Name or ID (jobTemplateUUID) Select a job template from a dropdown list loaded dynamically from ServiceM8, or specify a template ID via expression. This determines the base template used to create the new job.
Fields (fields) A collection of additional fields to customize the created job:
- job_description: Text description of the job.
- job_address: Street address where the job will take place.
- company_uuid: UUID of the company/client (cannot be used with company name).
- company_name: Name of the company/client; if it doesn't exist, a new company will be created (cannot be used with company UUID).

Output

The node outputs an array of JSON objects representing the newly created job(s) returned by the ServiceM8 API. Each object contains the full details of the created job, including identifiers, descriptions, addresses, company info, and other metadata as provided by the API response.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the ServiceM8 API.
  • Needs an API key credential configured in n8n for authentication with ServiceM8.
  • The node dynamically loads available job templates from the ServiceM8 API to populate the template selection dropdown.

Troubleshooting

  • Error: No fields to update were added — This error can occur if the required fields are missing or empty when attempting to create or update a job. Ensure that at least one valid field is provided.
  • Invalid template ID or name — If the specified job template does not exist or is misspelled, the API call will fail. Verify the template exists in ServiceM8 and is correctly referenced.
  • Conflicting company fields — Providing both company_uuid and company_name simultaneously is not allowed. Use only one to identify the company.
  • API authentication errors — Make sure the API key credential is correctly set up and has sufficient permissions.
  • Network or connectivity issues — Check your network connection and ServiceM8 service status if requests fail unexpectedly.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion