---
title: ServiceM8 API Integration on Truto
slug: servicem8
category: CRM
canonical: "https://truto.one/integrations/detail/servicem8/"
---

# ServiceM8 API Integration on Truto



**Category:** CRM  
**Status:** Generally available

## MCP-ready AI tools

Truto exposes 243 tools for ServiceM8 that AI agents can call directly.

- **create_a_service_m_8_account_provision** — Provision a new ServiceM8 account. Use this endpoint to create a new ServiceM8 account programatically. Specify the request parameters as a JSON object in the body of the request. Required: country, demo, business_name, email. ServiceM8 Partner accounts only.
- **delete_a_service_m_8_addon_account_key_value_by_id** — Delete one key for an account. Deletes a single key stored by your Addon against the authenticated account. Required: id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **get_single_service_m_8_addon_account_key_value_by_id** — Get one key for an account. Returns the value of a single key stored by your Addon against the authenticated account. Required: id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **update_a_service_m_8_addon_account_key_value_by_id** — Set one key for an account. Sets the value of a single key stored by your Addon against the authenticated account. Creates the key if it does not exist, or replaces the existing value. The request is rejected with a 413 response if the update would take the total storage for the account over the 64KB limit. Required: id, value. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **list_all_service_m_8_addon_account_key_values** — List all keys for an account. Returns all keys and values stored by your Addon against the authenticated account. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **get_single_service_m_8_addon_deployment_by_id** — Poll deployment status. Required: id, addon_slug. API-key connections only (the add-on developer's own key).
- **list_all_service_m_8_addon_identities** — Identify the authenticated account. Returns the ServiceM8 account the presented API key belongs to, and the key's access level. Used by developer tooling (the sm8 CLI) to validate credentials. API-key connections only (the add-on developer's own key).
- **delete_a_service_m_8_addon_job_key_value_by_id** — Delete one key for a job. Deletes a single key stored by your Addon against the given job. OAuth scope: manage_jobs or manage_addon_storage (either is sufficient). Required: id, job_id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **get_single_service_m_8_addon_job_key_value_by_id** — Get one key for a job. Returns the value of a single key stored by your Addon against the given job. OAuth scope: read_jobs or read_addon_storage (either is sufficient). Required: id, job_id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **update_a_service_m_8_addon_job_key_value_by_id** — Set one key for a job. Sets the value of a single key stored by your Addon against the given job. Creates the key if it does not exist, or replaces the existing value. The request is rejected with a 413 response if the update would take the total storage for the job over the 64KB limit. Required: id, job_id, value. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **list_all_service_m_8_addon_job_key_values** — List all keys for a job. Returns all keys and values stored by your Addon against the given job. OAuth scope: read_jobs or read_addon_storage (either is sufficient). Required: job_id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_addon_log_session** — Stream live logs for one add-on over SSE. Authenticates the developer and proxies CloudWatch Live Tail over SSE. AWS credentials remain server-side. Requires manage_addons or a full-access API key and Accept: text/event-stream. Required: addon_slug.
- **list_all_service_m_8_addon_manifest_schemas** — Get the add-on manifest v1 JSON Schema. Public, read-only JSON Schema for documentation and editor validation. Returns the same Draft 7 schema used by ServiceM8 manifest validation, without a response envelope. No API key, OAuth token or feature flag is required.
- **delete_a_service_m_8_addon_secret_by_id** — Delete a secret. Required: id, addon_slug. API-key connections only (the add-on developer's own key).
- **update_a_service_m_8_addon_secret_by_id** — Set a secret. Secrets are delivered to the add-on's function as environment variables and applied immediately - no redeploy required. Names are case-insensitive and canonicalized to UPPER_CASE. Requires a full-access API key. Required: id, addon_slug, value. API-key connections only (the add-on developer's own key).
- **list_all_service_m_8_addon_secrets** — List secret names for an add-on. Names only - values are never returned. Requires a full-access API key. Required: addon_slug. API-key connections only (the add-on developer's own key).
- **update_a_service_m_8_addon_by_id** — Deploy an add-on (atomic manifest + function upsert). Creates the add-on on first deploy (private/unlisted) and updates it thereafter. One multipart request carries the manifest JSON part and the bundled function source part. The manifest is validated before anything is committed. Returns 202 with a deployment id to poll. Required: id, manifest, function. API-key connections only (the add-on developer's own key).
- **get_single_service_m_8_addon_by_id** — Fetch one add-on by slug. Required: id. API-key connections only (the add-on developer's own key).
- **list_all_service_m_8_addons** — List the account's add-ons. API-key connections only (the add-on developer's own key).
- **create_a_service_m_8_allocation_window** — Create a new Allocation Window. OAuth scope: manage_schedule. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_allocation_windows** — List all Allocation Windows. OAuth scope: read_schedule. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_allocation_window_by_id** — Delete an Allocation Window. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_schedule. Required: id.
- **get_single_service_m_8_allocation_window_by_id** — Retrieve an Allocation Window. OAuth scope: read_schedule. Required: id.
- **update_a_service_m_8_allocation_window_by_id** — Update an Allocation Window. OAuth scope: manage_schedule. Required: id.
- **create_a_service_m_8_asset_type_field** — Create a new Asset Type Field. OAuth scope: manage_assets. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_asset_type_fields** — List all Asset Type Fields. OAuth scope: read_assets. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_asset_type_field_by_id** — Delete an Asset Type Field. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_assets. Required: id.
- **get_single_service_m_8_asset_type_field_by_id** — Retrieve an Asset Type Field. OAuth scope: read_assets. Required: id.
- **update_a_service_m_8_asset_type_field_by_id** — Update an Asset Type Field. OAuth scope: manage_assets. Required: id.
- **create_a_service_m_8_asset_type** — Create a new Asset Type. OAuth scope: manage_assets. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_asset_types** — List all Asset Types. OAuth scope: read_assets. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_asset_type_by_id** — Delete an Asset Type. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_assets. Required: id.
- **get_single_service_m_8_asset_type_by_id** — Retrieve an Asset Type. OAuth scope: read_assets. Required: id.
- **update_a_service_m_8_asset_type_by_id** — Update an Asset Type. OAuth scope: manage_assets. Required: id.
- **delete_a_service_m_8_asset_by_id** — Delete an Asset. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_assets. Required: id.
- **get_single_service_m_8_asset_by_id** — Retrieve an Asset. OAuth scope: read_assets. Required: id.
- **update_a_service_m_8_asset_by_id** — Update an Asset. OAuth scope: manage_assets. Required: id.
- **list_all_service_m_8_assets** — List all Assets. OAuth scope: read_assets. The connector pages through all results (up to 1,000 per page).
- **list_all_service_m_8_attachment_files** — Download an Attachment file. Retrieve the binary file associated with an Attachment. Authenticate the API request with an API key or an OAuth token with read_attachments. The API returns a 302 redirect; follow the Location header to retrieve the file bytes from storage. Required: attachment_id.
- **create_a_service_m_8_attachment** — Create a new Attachment. OAuth scope: manage_attachments. Required: file, related_object, related_object_uuid. Sends the file and its metadata in one multipart request (ServiceM8's recommended upload; the legacy raw upload to /attachment/{uuid}.file isn't available through the connector). ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_attachments** — List all Attachments. OAuth scope: read_attachments. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_attachment_by_id** — Delete an Attachment. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_attachments. Required: id.
- **get_single_service_m_8_attachment_by_id** — Retrieve an Attachment. OAuth scope: read_attachments. Required: id.
- **update_a_service_m_8_attachment_by_id** — Update an Attachment. OAuth scope: manage_attachments. Required: id.
- **create_a_service_m_8_availability** — Create a new Availability. OAuth scope: manage_schedule. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_availabilities** — List all Availabilities. OAuth scope: read_schedule. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_availability_by_id** — Delete an Availability. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_schedule. Required: id.
- **get_single_service_m_8_availability_by_id** — Retrieve an Availability. OAuth scope: read_schedule. Required: id.
- **update_a_service_m_8_availability_by_id** — Update an Availability. OAuth scope: manage_schedule. Required: id.
- **create_a_service_m_8_badge** — Create a new Badge. OAuth scope: manage_badges. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_badges** — List all Badges. OAuth scope: read_badges. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_badge_by_id** — Delete a Badge. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_badges. Required: id.
- **get_single_service_m_8_badge_by_id** — Retrieve a Badge. OAuth scope: read_badges. Required: id.
- **update_a_service_m_8_badge_by_id** — Update a Badge. OAuth scope: manage_badges. Required: id.
- **create_a_service_m_8_category** — Create a new Category. OAuth scope: manage_job_categories. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_categories** — List all Categories. OAuth scope: read_job_categories. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_category_by_id** — Delete a Category. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_categories. Required: id.
- **get_single_service_m_8_category_by_id** — Retrieve a Category. OAuth scope: read_job_categories. Required: id.
- **update_a_service_m_8_category_by_id** — Update a Category. OAuth scope: manage_job_categories. Required: id.
- **create_a_service_m_8_company** — Create a new Client. OAuth scope: manage_customers. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_companies** — List all Clients. OAuth scope: read_customers. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_company_by_id** — Delete a Client. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_customers. Required: id.
- **get_single_service_m_8_company_by_id** — Retrieve a Client. Open in ServiceM8 Use https://go.servicem8.com/OpenClient/{uuid} to open this Client in the ServiceM8 web app. This is a web app URL, not a REST API endpoint. Users who are not signed in are redirected through login and then back to the requested Client. OAuth scope: read_customers. Required: id.
- **update_a_service_m_8_company_by_id** — Update a Client. OAuth scope: manage_customers. Required: id.
- **create_a_service_m_8_company_contact** — Create a new Company Contact. OAuth scope: manage_customer_contacts. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_company_contacts** — List all Company Contacts. OAuth scope: read_customer_contacts. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_company_contact_by_id** — Delete a Company Contact. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_customer_contacts. Required: id.
- **get_single_service_m_8_company_contact_by_id** — Retrieve a Company Contact. OAuth scope: read_customer_contacts. Required: id.
- **update_a_service_m_8_company_contact_by_id** — Update a Company Contact. OAuth scope: manage_customer_contacts. Required: id.
- **service_m_8_custom_fields_bulk_delete** — Delete a Custom Field. Required: custom_field_id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error. The connector sends custom_field_id as ServiceM8's UUID form field.
- **list_all_service_m_8_custom_fields** — List Custom Fields. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_custom_field** — Create or Update a Custom Field. Creating and updating are identical, except that you must specify a uuid when updating an existing Custom Field. When creating a new Custom Field, the UUID will be returned in the JSON response. Required: object_name, field_name, display_name, field_type. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_diary_item** — Create an Add-on Job Diary item. Creates an immutable plaintext item in a Job Diary, attributed to the authenticated Add-on. Add-ons cannot read, update, or delete Diary items through this endpoint. Required: job_uuid, content. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **create_a_service_m_8_document_template** — Create a new Document Template. OAuth scope: manage_templates. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_document_templates** — List all Document Templates. OAuth scope: read_templates. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_document_template_by_id** — Delete a Document Template. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_templates. Required: id.
- **get_single_service_m_8_document_template_by_id** — Retrieve a Document Template. OAuth scope: read_templates. Required: id.
- **update_a_service_m_8_document_template_by_id** — Update a Document Template. OAuth scope: manage_templates. Required: id.
- **create_a_service_m_8_email_template** — Create a new Email Template. OAuth scope: manage_templates. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_email_templates** — List all Email Templates. OAuth scope: read_templates. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_email_template_by_id** — Delete an Email Template. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_templates. Required: id.
- **get_single_service_m_8_email_template_by_id** — Retrieve an Email Template. OAuth scope: read_templates. Required: id.
- **update_a_service_m_8_email_template_by_id** — Update an Email Template. OAuth scope: manage_templates. Required: id.
- **get_single_service_m_8_email_by_id** — Get one job email record. Returns a single job email record by UUID. Required: id.
- **list_all_service_m_8_emails** — List job email history. Returns merged inbound and outbound email history for jobs in the account. The connector pages through all results (up to 1,000 per page; limit sets the page size).
- **create_a_service_m_8_email** — Send an Email. Send an email through the ServiceM8 Messaging API. Email Signature You can include a staff member's email signature in your message by using the tag in your htmlBody or textBody. When this tag is present, the specified staff member's signature will be inserted at that location. Required: to, subject. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error. To insert a staff member's signature with <platform-user-signature />, pass impersonate_staff_uuid (sent as ServiceM8's x-impersonate-uuid header).
- **create_a_service_m_8_event_webhook_subscription** — Create or Update an Event Webhook Subscription. Subscribe to business events (e.g., job.created, job.completed). When the specified event occurs, a webhook will be sent to your callback URL with detailed event data. Your callback URL must return a successful 2xx response within 10 seconds. Required: event, callback_url. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_feed_post** — Post a message to the activity feed. The activity feed provides a central communication source within each ServiceM8 Account. It can be used to share important information, tips, reports and feedback. OAuth scope: publish_feed. Required: type, message, showActionBar.
- **create_a_service_m_8_feedback** — Create a new Feedback. OAuth scope: manage_feedback. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_feedback** — List all Feedback. OAuth scope: read_feedback. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_feedback_by_id** — Delete a Feedback. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_feedback. Required: id.
- **get_single_service_m_8_feedback_by_id** — Retrieve a Feedback. OAuth scope: read_feedback. Required: id.
- **update_a_service_m_8_feedback_by_id** — Update a Feedback. OAuth scope: manage_feedback. Required: id.
- **create_a_service_m_8_form_field** — Create a new Form Field. OAuth scope: manage_forms. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_form_fields** — List all Form Fields. OAuth scope: read_forms. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_form_field_by_id** — Delete a Form Field. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_forms. Required: id.
- **get_single_service_m_8_form_field_by_id** — Retrieve a Form Field. OAuth scope: read_forms. Required: id.
- **update_a_service_m_8_form_field_by_id** — Update a Form Field. OAuth scope: manage_forms. Required: id.
- **create_a_service_m_8_form_response** — Create a new Form Response. OAuth scope: manage_forms. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_form_responses** — List all Form Responses. OAuth scope: read_forms. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_form_response_by_id** — Delete a Form Response. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_forms. Required: id.
- **get_single_service_m_8_form_response_by_id** — Retrieve a Form Response. OAuth scope: read_forms. Required: id.
- **update_a_service_m_8_form_response_by_id** — Update a Form Response. OAuth scope: manage_forms. Required: id.
- **create_a_service_m_8_form** — Create a new Form. OAuth scope: manage_forms. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_forms** — List all Forms. OAuth scope: read_forms. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_form_by_id** — Delete a Form. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_forms. Required: id.
- **get_single_service_m_8_form_by_id** — Retrieve a Form. OAuth scope: read_forms. Required: id.
- **update_a_service_m_8_form_by_id** — Update a Form. OAuth scope: manage_forms. Required: id.
- **create_a_service_m_8_inbox_message_note** — Add note to message. Adds a note to an inbox message. Required: inbox_message_id, note.
- **service_m_8_inbox_messages_archive** — Archive or unarchive message. Archives or unarchives an inbox message. Required: inbox_message_id.
- **service_m_8_inbox_messages_attach** — Attach message to existing job. Attaches an inbox message to an existing job. Required: inbox_message_id, job_uuid.
- **service_m_8_inbox_messages_convert** — Convert message to job. Converts an inbox message into a new job, optionally using a job template. Required: inbox_message_id.
- **create_a_service_m_8_inbox_message** — Create a new inbox message. Creates a new inbox message that will appear in the inbox. Required: subject, message_text. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_inbox_messages** — List inbox messages. Retrieves a paginated list of inbox messages with optional filtering. The connector pages through all results with limit / offset (limit sets the page size, up to 500).
- **get_single_service_m_8_inbox_message_by_id** — Get inbox message details. Retrieves detailed information about a specific inbox message including attachments and conversation history. Required: id.
- **service_m_8_inbox_messages_confirm** — Mark message as read. Marks an inbox message as read. Required: inbox_message_id.
- **service_m_8_inbox_messages_pause** — Snooze or unsnooze message. Snoozes a message until a specified date/time or unsnoozes it. Required: inbox_message_id.
- **create_a_service_m_8_job_activity** — Create a new Job Activity. OAuth scope: manage_schedule. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_activities** — List all Job Activities. OAuth scope: read_schedule. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_activity_by_id** — Delete a Job Activity. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_schedule. Required: id.
- **get_single_service_m_8_job_activity_by_id** — Retrieve a Job Activity. OAuth scope: read_schedule. Required: id.
- **update_a_service_m_8_job_activity_by_id** — Update a Job Activity. OAuth scope: manage_schedule. Required: id.
- **get_single_service_m_8_job_admin_activity_by_id** — Retrieve a Job Activity. OAuth scope: read_job_admin_activity. Required: id.
- **list_all_service_m_8_job_admin_activities** — List all Job Activities. OAuth scope: read_job_admin_activity. The connector pages through all results (up to 1,000 per page).
- **create_a_service_m_8_job_allocation** — Create a new Job Allocation. OAuth scope: manage_schedule. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_allocations** — List all Job Allocations. OAuth scope: read_schedule. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_allocation_by_id** — Delete a Job Allocation. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_schedule. Required: id.
- **get_single_service_m_8_job_allocation_by_id** — Retrieve a Job Allocation. OAuth scope: read_schedule. Required: id.
- **update_a_service_m_8_job_allocation_by_id** — Update a Job Allocation. OAuth scope: manage_schedule. Required: id.
- **create_a_service_m_8_job_checklist** — Create a new Job Checklist. OAuth scope: manage_job_checklists. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_checklists** — List all Job Checklists. OAuth scope: read_job_checklists. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_checklist_by_id** — Delete a Job Checklist. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_checklists. Required: id.
- **get_single_service_m_8_job_checklist_by_id** — Retrieve a Job Checklist. OAuth scope: read_job_checklists. Required: id.
- **update_a_service_m_8_job_checklist_by_id** — Update a Job Checklist. OAuth scope: manage_job_checklists. Required: id.
- **create_a_service_m_8_job_contact** — Create a new Job Contact. OAuth scope: manage_job_contacts. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_contacts** — List all Job Contacts. OAuth scope: read_job_contacts. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_contact_by_id** — Delete a Job Contact. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_contacts. Required: id.
- **get_single_service_m_8_job_contact_by_id** — Retrieve a Job Contact. OAuth scope: read_job_contacts. Required: id.
- **update_a_service_m_8_job_contact_by_id** — Update a Job Contact. OAuth scope: manage_job_contacts. Required: id.
- **create_a_service_m_8_job_material_bundle** — Create a new Job Material Bundle. OAuth scope: manage_job_materials. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_material_bundles** — List all Job Material Bundles. OAuth scope: read_job_materials. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_material_bundle_by_id** — Delete a Job Material Bundle. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_materials. Required: id.
- **get_single_service_m_8_job_material_bundle_by_id** — Retrieve a Job Material Bundle. OAuth scope: read_job_materials. Required: id.
- **update_a_service_m_8_job_material_bundle_by_id** — Update a Job Material Bundle. OAuth scope: manage_job_materials. Required: id.
- **create_a_service_m_8_job_material** — Create a new Job Material. OAuth scope: manage_job_materials. Required: quantity. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_materials** — List all Job Materials. OAuth scope: read_job_materials. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_material_by_id** — Delete a Job Material. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_materials. Required: id.
- **get_single_service_m_8_job_material_by_id** — Retrieve a Job Material. OAuth scope: read_job_materials. Required: id.
- **update_a_service_m_8_job_material_by_id** — Update a Job Material. OAuth scope: manage_job_materials. Required: id.
- **create_a_service_m_8_job_payment** — Create a new Job Payment. OAuth scope: manage_job_payments. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_job_payments** — List all Job Payments. OAuth scope: read_job_payments. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_payment_by_id** — Delete a Job Payment. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_payments. Required: id.
- **get_single_service_m_8_job_payment_by_id** — Retrieve a Job Payment. OAuth scope: read_job_payments. Required: id.
- **update_a_service_m_8_job_payment_by_id** — Update a Job Payment. OAuth scope: manage_job_payments. Required: id.
- **list_all_service_m_8_job_semantic_search_results** — Semantic search for jobs. Harness the power of advanced AI embeddings to revolutionise how you search through job data. This endpoint transforms your search query into high-dimensional vector embeddings, then intelligently matches it against our entire job database using semantic similarity algorithms. Required: q.
- **create_a_service_m_8_job_template_job** — Create a job from a template. Creates a new job by cloning an existing job template. All template entities (tasks, materials, checklists, quotes, custom fields) are cloned to the new job. OAuth scope: create_jobs. Required: job_template_id.
- **get_single_service_m_8_job_template_by_id** — Retrieve a Job Template. OAuth scope: read_jobs. Required: id.
- **list_all_service_m_8_job_templates** — List all Job Templates. OAuth scope: read_jobs. The connector pages through all results (up to 1,000 per page).
- **create_a_service_m_8_job** — Create a new Job. OAuth scope: create_jobs. Required: status. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_jobs** — List all Jobs. OAuth scope: read_jobs. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_job_by_id** — Delete a Job. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_jobs. Required: id.
- **get_single_service_m_8_job_by_id** — Retrieve a Job. Open in ServiceM8 Use https://go.servicem8.com/OpenJob/{uuid} to open this Job in the ServiceM8 web app. This is a web app URL, not a REST API endpoint. Users who are not signed in are redirected through login and then back to the requested Job. OAuth scope: read_jobs. Required: id.
- **update_a_service_m_8_job_by_id** — Update a Job. OAuth scope: manage_jobs. Required: id.
- **create_a_service_m_8_knowledge_article** — Create a new Knowledge Article. OAuth scope: manage_knowledge. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_knowledge_articles** — List all Knowledge Articles. OAuth scope: read_knowledge. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_knowledge_article_by_id** — Delete a Knowledge Article. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_knowledge. Required: id.
- **get_single_service_m_8_knowledge_article_by_id** — Retrieve a Knowledge Article. OAuth scope: read_knowledge. Required: id.
- **update_a_service_m_8_knowledge_article_by_id** — Update a Knowledge Article. OAuth scope: manage_knowledge. Required: id.
- **create_a_service_m_8_location** — Create a new Location. OAuth scope: manage_locations. Required: name, state. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_locations** — List all Locations. OAuth scope: read_locations. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_location_by_id** — Delete a Location. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_locations. Required: id.
- **get_single_service_m_8_location_by_id** — Retrieve a Location. OAuth scope: read_locations. Required: id.
- **update_a_service_m_8_location_by_id** — Update a Location. OAuth scope: manage_locations. Required: id.
- **create_a_service_m_8_material_bundle** — Create a new Bundle. OAuth scope: manage_inventory. Required: item_number. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_material_bundles** — List all Bundles. OAuth scope: read_inventory. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_material_bundle_by_id** — Delete a Bundle. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_inventory. Required: id.
- **get_single_service_m_8_material_bundle_by_id** — Retrieve a Bundle. OAuth scope: read_inventory. Required: id.
- **update_a_service_m_8_material_bundle_by_id** — Update a Bundle. OAuth scope: manage_inventory. Required: id.
- **create_a_service_m_8_material** — Create a new Material. OAuth scope: manage_inventory. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_materials** — List all Materials. OAuth scope: read_inventory. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_material_by_id** — Delete a Material. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_inventory. Required: id.
- **get_single_service_m_8_material_by_id** — Retrieve a Material. OAuth scope: read_inventory. Required: id.
- **update_a_service_m_8_material_by_id** — Update a Material. OAuth scope: manage_inventory. Required: id.
- **create_a_service_m_8_note** — Create a new Note. OAuth scope: publish_job_notes. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_notes** — List all Notes. OAuth scope: read_job_notes. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_note_by_id** — Delete a Note. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: publish_job_notes. Required: id.
- **get_single_service_m_8_note_by_id** — Retrieve a Note. OAuth scope: read_job_notes. Required: id.
- **update_a_service_m_8_note_by_id** — Update a Note. OAuth scope: publish_job_notes. Required: id.
- **create_a_service_m_8_notification** — Create add-on notifications. Sends a notification from the calling add-on to each supplied staff recipient. Required: recipient_staff_uuids, message. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_object_search_results** — Search within a specific object type. Performs a text search within a specific object type. Supported types: job, company, material, knowledgearticle, attachment, formresponse, asset, materialbundle. Required: q, object_type.
- **create_a_service_m_8_object_webhook_subscription** — Create or Update an Object Webhook Subscription. Subscribe to changes on specific fields of an object type (e.g., job, company). When any of the specified fields change, a webhook will be sent to your callback URL. Your callback URL must return a successful 2xx response within 10 seconds. Required: object, fields, callback_url. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_produced_document** — Produce a Templated Document. Use this endpoint to combine Objects with Document Templates to produce PDF, DOCX or JPG output. Specify the request parameters as a JSON object in the body of the request. Required: objectType, objectUUID, templateType, outputFormat. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_queue** — Create a new Job Queue. OAuth scope: manage_job_queues. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_queues** — List all Job Queues. OAuth scope: read_job_queues. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_queue_by_id** — Delete a Job Queue. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_job_queues. Required: id.
- **get_single_service_m_8_queue_by_id** — Retrieve a Job Queue. OAuth scope: read_job_queues. Required: id.
- **update_a_service_m_8_queue_by_id** — Update a Job Queue. OAuth scope: manage_job_queues. Required: id.
- **list_all_service_m_8_search_results** — Search across multiple object types. Performs a text search across jobs, companies, and materials. Returns combined results sorted by relevance. Required: q.
- **get_single_service_m_8_security_role_by_id** — Retrieve a Security Role. OAuth scope: read_security_roles. Required: id.
- **list_all_service_m_8_security_roles** — List all Security Roles. OAuth scope: read_security_roles. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_service_template_by_id** — Soft-delete a ServiceTemplate. Sets active=0. Deleting an editable row also soft-deletes its published copy via the existing Service postCommit cascade; deleting a published-copy UUID only deactivates that published row. Required: id.
- **get_single_service_m_8_service_template_by_id** — Get a ServiceTemplate. Retrieves one editable or published Service record by UUID. Required: id.
- **update_a_service_m_8_service_template_by_id** — Create or update a ServiceTemplate. Creates or sparsely updates an editable Service record. Published-copy UUIDs and publishing fields are rejected. Required: id.
- **list_all_service_m_8_service_templates** — List ServiceTemplates. Lists editable and published Service records, including inactive records. Filtering applies to top-level Service fields only. The connector pages through all results (up to 1,000 per page; limit sets the page size).
- **get_single_service_m_8_sms_message_by_id** — Get one job SMS record. Returns a single merged job SMS record by UUID. Required: id.
- **list_all_service_m_8_sms_messages** — List job SMS history. Returns merged inbound and outbound SMS history for jobs in the account. The connector pages through all results (up to 1,000 per page; limit sets the page size).
- **create_a_service_m_8_sms_message** — Send an SMS Message. Important: Sending messages via this endpoint will incur SMS charges. Marketing and promotional SMS is not permitted. The From address of SMS messages sent via the Messaging API depends on the user's Country/Region. Required: to, message. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **create_a_service_m_8_sms_template** — Create a new SMS Template. OAuth scope: manage_templates. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_sms_templates** — List all SMS Templates. OAuth scope: read_templates. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_sms_template_by_id** — Delete a SMS Template. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_templates. Required: id.
- **get_single_service_m_8_sms_template_by_id** — Retrieve a SMS Template. OAuth scope: read_templates. Required: id.
- **update_a_service_m_8_sms_template_by_id** — Update a SMS Template. OAuth scope: manage_templates. Required: id.
- **create_a_service_m_8_staff** — Create a new Staff Member. OAuth scope: manage_staff. Required: first, last. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_staff** — List all Staff Members. OAuth scope: read_staff. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_staff_by_id** — Delete a Staff Member. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_staff. Required: id.
- **get_single_service_m_8_staff_by_id** — Retrieve a Staff Member. OAuth scope: read_staff. Required: id.
- **update_a_service_m_8_staff_by_id** — Update a Staff Member. OAuth scope: manage_staff. Required: id.
- **create_a_service_m_8_staff_message** — Create a new Staff Message. OAuth scope: publish_messages. Required: from_staff_uuid, to_staff_uuid. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_staff_messages** — List all Staff Messages. OAuth scope: read_messages. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_staff_message_by_id** — Delete a Staff Message. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: publish_messages. Required: id.
- **get_single_service_m_8_staff_message_by_id** — Retrieve a Staff Message. OAuth scope: read_messages. Required: id.
- **update_a_service_m_8_staff_message_by_id** — Update a Staff Message. OAuth scope: publish_messages. Required: id.
- **get_single_service_m_8_staff_time_event_by_id** — Retrieve a Staff Time Event. Staff clock-on, clock-off and lunch-break events, separate from job check-in activity. These are historical events, not a current clock-on status indicator. Read events using an API key with read access or OAuth with read_staff_time_events. OAuth scope: read_staff_time_events. Required: id.
- **list_all_service_m_8_staff_time_events** — List all Staff Time Events. Staff clock-on, clock-off and lunch-break events, separate from job check-in activity. These are historical events, not a current clock-on status indicator. Read events using an API key with read access or OAuth with read_staff_time_events. OAuth scope: read_staff_time_events. The connector pages through all results (up to 1,000 per page).
- **create_a_service_m_8_supplier** — Create a new Supplier. OAuth scope: manage_suppliers. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_suppliers** — List all Suppliers. OAuth scope: read_suppliers. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_supplier_by_id** — Delete a Supplier. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_suppliers. Required: id.
- **get_single_service_m_8_supplier_by_id** — Retrieve a Supplier. OAuth scope: read_suppliers. Required: id.
- **update_a_service_m_8_supplier_by_id** — Update a Supplier. OAuth scope: manage_suppliers. Required: id.
- **create_a_service_m_8_task** — Create a new Task. OAuth scope: manage_tasks. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_tasks** — List all Tasks. OAuth scope: read_tasks. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_task_by_id** — Delete a Task. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_tasks. Required: id.
- **get_single_service_m_8_task_by_id** — Retrieve a Task. OAuth scope: read_tasks. Required: id.
- **update_a_service_m_8_task_by_id** — Update a Task. OAuth scope: manage_tasks. Required: id.
- **create_a_service_m_8_tax_rate** — Create a new Tax Rate. OAuth scope: manage_tax_rates. Required: name. ServiceM8 returns the new record's UUID in the x-record-uuid response header; or send your own uuid in the body.
- **list_all_service_m_8_tax_rates** — List all Tax Rates. OAuth scope: read_tax_rates. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_tax_rate_by_id** — Delete a Tax Rate. In ServiceM8, deleting a record sets its active field to 0. Inactive records are still accessible on the API, but are hidden in the UI. Inactive records can be restored by setting their active field to 1. OAuth scope: manage_tax_rates. Required: id.
- **get_single_service_m_8_tax_rate_by_id** — Retrieve a Tax Rate. OAuth scope: read_tax_rates. Required: id.
- **update_a_service_m_8_tax_rate_by_id** — Update a Tax Rate. OAuth scope: manage_tax_rates. Required: id.
- **get_single_service_m_8_vendor_by_id** — Retrieve a Vendor. Vendor account information OAuth scope: vendor. Required: id.
- **list_all_service_m_8_vendors** — List all Vendors. Vendor account information OAuth scope: vendor. The connector pages through all results (up to 1,000 per page).
- **delete_a_service_m_8_webhook_subscription_by_id** — Delete a Webhook Subscription. Delete (deactivate) a single webhook subscription. You must specify the webhook subscription UUID in the request path; deleting multiple webhook subscriptions with one request is not supported. Required: id. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.
- **list_all_service_m_8_webhook_subscriptions** — List Webhook Subscriptions. List all your current webhook subscriptions. Use status=inactive or status=all to inspect subscriptions that have been automatically deactivated after repeated delivery failures. The last_failure_reason and last_failure_at fields can help diagnose the last recorded failure. Needs an OAuth connection (ServiceM8 limits it to public add-ons); with an API key ServiceM8 returns an error.

## How it works

1. **Link your customer's ServiceM8 account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach ServiceM8.** The Proxy API is a 1-to-1 mapping of the ServiceM8 API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Automate Quote-to-Cash for Trades Accounting Platforms** — Accounting and bookkeeping SaaS products can sync completed ServiceM8 jobs, materials, and payments into their ledger, eliminating double entry for electricians, plumbers, and HVAC contractors. Truto handles OAuth, pagination, and webhook delivery so you can ship the integration in days.
- **Power AI Receptionists and Lead Capture Tools** — Virtual receptionist and web-booking SaaS products can push inbound calls, chats, and form submissions straight into ServiceM8 as inbox messages or draft jobs. Dispatchers see new work on their board in real time without manual data entry.
- **Feed Field Technician Timesheets into Payroll** — Payroll and workforce management platforms can pull staff time events, job activities, and allocations from ServiceM8 to calculate wages for field crews automatically. This removes the weekly timesheet-chasing pain for small trade businesses.
- **Trigger Review Requests and Marketing Campaigns on Job Completion** — Reputation management and marketing automation SaaS products can subscribe to ServiceM8 event webhooks and fire SMS or email campaigns the moment a job completes. Pull company contact data to personalize outreach without any dispatcher involvement.
- **Sync Supplier Catalogs into Contractor Material Lists** — Wholesale suppliers and inventory SaaS platforms can push live material pricing into their contractors' ServiceM8 accounts, ensuring quotes always reflect current hardware costs. This gives suppliers a sticky, native presence inside their customers' daily workflow.

## What you can build

- **Two-way job and invoice sync** — Create, update, and read ServiceM8 jobs, job materials, and job payments to keep your product's work orders and your customer's dispatch board perfectly aligned.
- **Real-time dispatch via inbox messages** — Use inbox message creation and the convert action to turn chatbot threads, voice transcripts, or form submissions into scheduled ServiceM8 jobs instantly.
- **Compliance document backup** — Pull completed form responses, signed checklists, and job attachments out of ServiceM8 on a schedule to archive safety certificates and photo evidence in your platform.
- **Technician time and attendance pipeline** — Stream staff time events, job allocations, and job activities into payroll or workforce analytics dashboards to calculate labor costs and billable utilization.
- **Customer directory sync for CRM and marketing** — Keep companies and company contacts in sync between ServiceM8 and your CRM, enabling segmentation, campaigns, and post-service review requests triggered by webhooks.
- **Live material and price catalog push** — Create and update materials and material bundles in ServiceM8 so suppliers or ERP systems can maintain accurate pricing inside the contractor's quoting workflow.

## FAQs

### How does authentication work for ServiceM8 through Truto?

Truto handles the ServiceM8 OAuth flow end-to-end. Your end users click a connect button in your product, authorize access to their ServiceM8 account, and Truto securely stores and refreshes the tokens — you never see or manage credentials.

### Can we receive real-time updates when jobs or activities change?

Yes. ServiceM8 supports event and object webhook subscriptions, and Truto exposes endpoints to create and manage these subscriptions. You can listen for job, activity, and inbox message changes without polling.

### Does Truto support ServiceM8 custom fields and forms?

Yes. You can list and create custom fields, and read form definitions, form fields, and submitted form responses. This lets you capture industry-specific compliance data like electrical safety certificates or plumbing inspection reports.

### Which ServiceM8 operations are supported — read-only or full read/write?

Full read/write across the major objects. You can create, read, update, and delete jobs, job materials, job allocations, companies, contacts, staff, materials, tax rates, forms, templates, and more. Attachments, time events, and admin activities are read-focused as the ServiceM8 API dictates.

### How fresh is the data we read from ServiceM8?

Reads hit the ServiceM8 API live, so data reflects the current state at request time. For near-real-time use cases like dispatch or review triggers, subscribe to event webhooks via Truto rather than polling list endpoints.

### Can we automate job creation from external sources like AI voice agents or web forms?

Yes. Use the create job endpoint for structured work orders, or create inbox messages and call the convert action to turn unstructured conversations into jobs — ideal for AI receptionists, chatbots, and lead capture tools.
