ServiceM8 icon

ServiceM8

ServiceM8 Node

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. This is useful for automating job creation when many jobs share common attributes or structures defined in templates.

Typical use cases include:

  • Quickly creating standardized jobs for recurring tasks using predefined templates.
  • Automating job creation workflows where job details are partially fixed but require customization (e.g., different client or address).
  • Integrating job creation into larger automation pipelines that handle scheduling, notifications, or client management.

For example, a field service company could use this node to generate new work orders from templates, filling in client-specific information dynamically.

Properties

Name Meaning
Job Template ID Or Name or ID (jobTemplateUUID) Select a job template from a list or specify its ID via expression. The template defines the base structure of the job to be created.
Fields (fields) Collection of additional job details 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 associated with the job. Cannot be used together with Company Name.
- company_name Name of the company/client. If it exists, it will be used; otherwise, a new company will be created. Cannot be used together with Company UUID.

Output

The node outputs an array of JSON objects representing the created job(s). Each object contains the response data returned by the ServiceM8 API after creating the job from the specified template, including identifiers and any other job metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active ServiceM8 account and API access.
  • Needs an API authentication credential configured in n8n to authorize requests to the ServiceM8 API.
  • The node uses the ServiceM8 REST API endpoint for job templates and job creation.

Troubleshooting

  • Error: No fields to update were added
    This error can occur if the fields collection is empty or missing required data when updating a job. For "createFromTemplate," ensure at least the job template ID and necessary fields are provided.

  • Invalid or missing Job Template ID
    If the selected job template does not exist or the ID is incorrect, the API request will fail. Verify the template selection or expression.

  • Conflict between Company UUID and Company Name
    Both cannot be set simultaneously. Remove one to avoid conflicts.

  • API Authentication Errors
    Ensure the API key credential is correctly configured and has sufficient permissions.

  • Network or API Rate Limits
    Network issues or exceeding API rate limits may cause failures. Check connectivity and ServiceM8 API usage policies.

Links and References

Discussion