ServiceM8 icon

ServiceM8

ServiceM8 Node

Overview

This node integrates with the ServiceM8 platform, allowing users to perform various operations on different resources such as Clients, Jobs, Emails, and SMS messages. Specifically, for the Client - Get operation, it retrieves detailed information about a single client identified by a UUID.

Typical use cases include:

  • Fetching client details to display or process in workflows.
  • Integrating client data retrieval into automated business processes.
  • Using client information to trigger further actions like job creation or communication.

For example, you might use this node to get a client's contact details before scheduling a service job or sending a notification.

Properties

Name Meaning
UUID The unique identifier (UUID) of the client to retrieve. This is a required string input that specifies which client record to fetch from ServiceM8.

Output

The node outputs an array of JSON objects representing the retrieved client data. Each object contains all available fields returned by the ServiceM8 API for the specified client, such as name, contact details, address, and any other client-specific metadata.

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 depends on network access to the ServiceM8 REST API endpoints.
  • No additional external services are needed beyond the ServiceM8 API.

Troubleshooting

  • Common issues:

    • Providing an invalid or empty UUID will result in failure to retrieve client data.
    • Network connectivity problems can cause request timeouts or errors.
    • Insufficient permissions or incorrect API credentials may lead to authorization errors.
  • Error messages and resolutions:

    • "No fields to update were added" — Not applicable for the Get operation but indicates missing input fields if encountered in other operations.
    • API errors related to authentication usually mean the API key credential needs verification or reconfiguration.
    • If the node throws an error about missing parameters, ensure the UUID property is correctly set and not empty.

Links and References

Discussion