ServiceM8 icon

ServiceM8

ServiceM8 Node

Actions14

Overview

This node integrates with the ServiceM8 platform to send SMS messages. It allows users to send text messages directly through ServiceM8's SMS service, linking messages optionally to specific jobs within ServiceM8. This is useful for businesses that want to automate communication with clients or staff by sending notifications, reminders, or updates via SMS.

Common scenarios:

  • Sending appointment reminders to customers.
  • Notifying clients about job status updates.
  • Communicating urgent information related to a specific job.
  • Automating follow-up messages after job completion.

Practical example:
A field service company can use this node to automatically send an SMS reminder to a client one day before their scheduled appointment, including details linked to the job in ServiceM8.

Properties

Name Meaning
To Phone number of the message recipient in E.164 format (e.g., +1234567890), including the plus prefix, country code, and area code.
Message Content of the SMS message. Note that special characters are not supported. Messages longer than 153 characters will consume multiple SMS credits.
Regarding Job UUID UUID of the job that this message relates to. Linking the SMS to a job causes it to appear in the job diary within ServiceM8. Optional.

Output

The node outputs an array of JSON objects representing the response from the ServiceM8 API after sending the SMS. Each object typically contains details about the sent message, such as status, message ID, and any metadata returned by the API.

If the operation succeeds, the output confirms the SMS was sent and linked (if applicable). There is no binary data output for this operation.

Dependencies

  • Requires an active ServiceM8 account with API access.
  • Needs an API key credential configured in n8n for authenticating requests to ServiceM8.
  • The node makes HTTP POST requests to the ServiceM8 SMS endpoint (https://api.servicem8.com/platform_service_sms).

Troubleshooting

  • Invalid phone number format: Ensure the "To" property uses the E.164 format with the "+" prefix and correct country/area codes.
  • Message too long or containing unsupported characters: Keep messages under 153 characters and avoid special characters to prevent errors or extra credit usage.
  • Missing job UUID: If you want the SMS linked to a job, provide a valid job UUID; otherwise, the message won't appear in the job diary.
  • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
  • Network or API errors: Check network connectivity and ServiceM8 API status if requests fail unexpectedly.
  • No fields provided error: If the required fields ("to" and "message") are empty, the node may throw an error indicating missing input.

Links and References

Discussion