ServiceM8 Getting Started

ServiceM8 can connect to Neudash through OAuth. If you’re configuring a ServiceM8 app or add-on, there are two URLs you must understand:

  • Addon Activation URL: the user-facing page ServiceM8 opens when the add-on is activated
  • OAuth Callback URL: the machine-facing URL ServiceM8 redirects back to after the user authorizes access

These are different and should not be set to the same value.

Use these URLs

Addon Activation URL

https://neudash.com/integrations/servicem8/gettingstarted

Use this in the ServiceM8 app configuration for the add-on activation/start page.

OAuth Callback URL

https://connect.neudash.com/callback/servicem8

Use this as the OAuth redirect/callback URI in the ServiceM8 app configuration.

What each URL does

Addon Activation URL

This is the entry page a user sees when they activate the add-on from ServiceM8. In Neudash it is a public setup page that:

  • explains that setup continues in Neudash
  • lets the user sign in if needed
  • preserves the incoming activation context for future setup improvements

OAuth Callback URL

This is where ServiceM8 sends the browser back after OAuth authorization. Neudash uses it to finish the OAuth connection and store the resulting tokens.

Do not set the activation URL to the callback URL.

Platform client vs custom client

Neudash supports ServiceM8 as an OAuth provider.

Platform client

This is the recommended path. Use the Neudash-managed ServiceM8 OAuth client unless you have a specific reason to bring your own app.

Custom client

Use a custom ServiceM8 OAuth app only when you need your own app ownership, Store Connect configuration, or policy controls.

Basic setup flow

  1. Configure the ServiceM8 app with the URLs above
  2. In Neudash, create or reuse a ServiceM8 OAuth connection
  3. In the connect flow, choose the Neudash platform client unless you explicitly need a custom client
  4. Authorize the connection
  5. Link the connection to a process or automation

For current ServiceM8 automations in Neudash, the usual pattern is:

  • OAuth connection
  • schedule trigger
  • process code that polls the ServiceM8 REST API

ServiceM8 is not currently a native Neudash remote-subscription provider.

Troubleshooting

Redirect URI mismatch

Double-check that the callback URL is exactly:

https://connect.neudash.com/callback/servicem8

Common mistakes:

  • using neudash.com instead of connect.neudash.com for the callback
  • adding a trailing slash
  • setting the activation URL and callback URL to the same value

Add-on opens the wrong page

Double-check that the ServiceM8 add-on activation URL is:

https://neudash.com/integrations/servicem8/gettingstarted

Connection exists but is still pending

The OAuth connection may already be created in Neudash but still need user authorization. Open the configuration page and complete the connect flow before testing automations.