All Toolkits

Servicem8

Latest version

ServiceM8 helps field service businesses schedule jobs, send quotes, and manage invoices, offering staff mobile apps and real-time job status tracking

Authentication DetailsComposio-managed OAuth available

Frequently Asked Questions

How do I set up custom OAuth credentials for ServiceM8?

Composio-managed OAuth works for ServiceM8 without any setup. Use your own ServiceM8 add-on when you want your app name on the consent screen and control over its permissions. You need a ServiceM8 developer account.

Create the ServiceM8 add-on

  1. Sign in to ServiceM8 and open Developer from the main menu. On Store Items, click Add Item.

    ServiceM8 Store Items page with the Add Item button

  2. Enter a Name and Description. Keep Category set to Add-on, choose a price (Free works for a private integration), and click Save. ServiceM8 opens the add-on's settings.

    ServiceM8 New Store Item form with name, Add-on category, description and Free price

  3. Scroll to Addon OAuth Credentials and copy the App Id and App Secret. These are the client ID and client secret in Composio.

    ServiceM8 add-on settings showing Addon OAuth Credentials and Addon Type set to External Integration

  4. Under Addon SDK, set Addon Type to External Integration.

  5. Set Addon Activation URL to https://backend.composio.dev/api/v1/auth-apps/add and click Save. ServiceM8 checks the OAuth redirect host against this URL, so it must match the auth config's oauth_redirect_uri field. See ServiceM8's authentication docs.

    ServiceM8 Addon SDK settings with the Composio Addon Activation URL and Save button

Create the auth config in Composio

  1. In the Composio dashboard, go to Auth Configs → Create and select ServiceM8.

    Composio Auth Configs page with the Create button

    Composio Create Auth Config dialog with ServiceM8 in the search results

  2. Choose OAuth 2.0 and Your Own Credentials. Enter the App Id as the client ID and the App Secret as the client secret. Keep the default redirect URI.

    ServiceM8 auth config form with OAuth 2.0 and Your Own Credentials selected

  3. Under Scopes, choose the permissions your tools need, then click Create Auth Config.

    Saved ServiceM8 auth config with custom credentials, the Composio redirect URI and the read_jobs scope

  4. Click Connect Account and sign in to the ServiceM8 account you want to connect. A new draft add-on shows This Addon isn't verified; confirm it's your add-on and click Proceed. Check the app name and permissions, then click Allow.

    ServiceM8 This Addon isn't verified warning with the Proceed button

    ServiceM8 consent screen requesting read-only access to jobs with the Allow button

  5. Open the auth config's Accounts tab and confirm the account shows Active. The auth config's own Enabled label doesn't mean an account is connected.

    Composio auth config Accounts tab with a ServiceM8 connected account showing Active

See custom auth configs for the general flow.

Scopes

ServiceM8 permissions are per resource, such as read_jobs, manage_jobs, read_customers, manage_customers, read_staff, and read_schedule. The default auth config requests read and manage permissions across jobs, customers, staff, schedule, inventory, assets, and messaging. A read-only jobs integration needs only read_jobs. See ServiceM8's scope descriptions.

The add-on can stay a draft. Publishing it to the ServiceM8 directory is a separate process, and submitting the add-on for review removes the unverified warning.