Actions14
- Client Actions
- Email Actions
- Job Actions
- Search Actions
- SMS Actions
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 update operation.
- Proper configuration of the API credentials within n8n is necessary for successful execution.
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 and its value are specified.
- Invalid UUID: If the UUID does not correspond to an existing job, the API will return an error. Verify that the UUID is correct.
- API authentication errors: Check that the API key credential is correctly configured and has sufficient permissions.
- Network or connectivity issues: Ensure that n8n can reach the ServiceM8 API endpoints without firewall or proxy restrictions.
Links and References
- ServiceM8 API Documentation
- n8n Expressions Documentation (for using expressions in field names)