ServiceM8 icon

ServiceM8

ServiceM8 Node

Actions11

Overview

The node integrates with the ServiceM8 API to perform various operations on different resources such as Clients, Jobs, Emails, and SMS. Specifically for the Job - Update operation, it allows users to update one or more fields of an existing job identified by its UUID. This is useful in scenarios where job details need to be modified after creation, such as changing status, updating descriptions, or adjusting scheduling information.

Practical examples include:

  • Updating the status of a job when work progresses.
  • Changing the assigned staff member or due date.
  • Modifying custom fields related to the job.

Properties

Name Meaning
UUID The unique identifier (UUID) of the job to update.
Fields A collection of fields to update on the job. Each entry includes:
- Field Name or ID: Selectable from a list of available job fields or specified via expression.
- Value: The new value to assign to the selected field.

Output

The node outputs a JSON array containing the response from the ServiceM8 API after the update operation. Each item corresponds to the updated job data returned by the API. The structure typically reflects the job object with updated fields as confirmed by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the ServiceM8 API.
  • The node depends on the ServiceM8 REST API endpoints.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • No fields to update were added: This error occurs if the "Fields" property is empty or no valid fields are provided. Ensure at least one field with a valid name and value is specified.
  • Invalid UUID: If the UUID does not correspond to an existing job, the API will likely return an error. Verify the UUID is correct.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network or API errors: Check network connectivity and ServiceM8 service status if requests fail unexpectedly.

Links and References

Discussion