ServiceM8 icon

ServiceM8

ServiceM8 Node
Join our community

Actions11

Overview

This node integrates with the ServiceM8 platform, allowing users to manage various resources such as clients, jobs, emails, and SMS messages. Specifically, the Add Note To Job operation enables users to add a note to an existing job within ServiceM8. This is useful for logging updates, comments, or additional information related to a job directly from an automated workflow.

Practical examples include:

  • Automatically appending notes to jobs when certain triggers occur (e.g., a customer sends an update).
  • Adding internal comments or instructions to jobs based on external system events.
  • Logging status changes or reminders in the job record without manual intervention.

Properties

Name Meaning
Fields A collection of fields to define the note details:
- Note: The text content of the note to be added to the job.
- Job UUID: The unique identifier of the job to which the note will be attached.

Output

The node outputs a JSON array where each element corresponds to the response from the ServiceM8 API after adding a note to a job. The structure typically includes confirmation details about the created note, such as its ID, content, timestamps, and association with the specified job.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the ServiceM8 API via an API key credential configured in n8n.
  • The node uses HTTP POST requests to interact with the ServiceM8 API endpoints.
  • Proper permissions on the ServiceM8 account are necessary to add notes to jobs.

Troubleshooting

  • Common issues:

    • Missing or invalid Job UUID: The operation requires a valid job identifier; ensure the UUID is correct and corresponds to an existing job.
    • Empty note content: If no note text is provided, the API may reject the request or create an empty note.
    • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.

  • Error messages:

    • "No fields to update were added": This error can occur if the required fields are missing or empty. For adding a note, ensure the "Note" and "Job UUID" fields are properly filled.
    • API response errors indicating invalid UUID or permission denied should be resolved by checking the job existence and user rights.

Links and References

Discussion