ServiceM8 icon

ServiceM8

ServiceM8 Node
Join our community

Actions14

Overview

This node integrates with the ServiceM8 platform, specifically allowing users to update existing Job records. The "Update Job" operation lets you modify one or more fields of a job identified by its UUID. This is useful in scenarios where job details need to be corrected or enhanced after creation, such as updating status, client information, scheduling details, or custom fields.

Practical examples include:

  • Changing the scheduled date/time of a job.
  • Updating the assigned staff member.
  • Modifying job notes or descriptions.
  • Adjusting job priority or status based on new information.

Properties

Name Meaning
UUID The unique identifier of the Job to update.
Fields A collection of fields to update on the Job. Each entry includes:
- Field Name or ID: Select from available job fields or specify an expression for the field.
- Value: The new value to assign to the selected field.

Output

The node outputs an array of JSON objects representing the updated Job(s). Each object contains the full details of the Job after the update operation, reflecting all changes made.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the ServiceM8 API.
  • The node makes HTTP POST requests to the ServiceM8 API endpoint corresponding to the Job resource and update operation.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • No fields to update were added: This error occurs if the "Fields" property is empty when attempting to update a Job. Ensure at least one field and its value are specified.
  • Invalid UUID: If the provided UUID does not correspond to an existing Job, the API will return an error. Verify the UUID is correct.
  • API Authentication Errors: If the API key is missing or invalid, requests will fail. Confirm that the API credentials are correctly configured.
  • Network or API errors: General connectivity issues or API downtime can cause failures. Check network access and ServiceM8 service status.

Links and References

Discussion