# ServiceM8 (/docs/features/integrations/servicem8-integration) ServiceM8 lets you bring job details into supported Tradie Forms fields without retyping them on site. Read the overview on the [ServiceM8 integration page](/integrations/servicem8). ## Requirements [#requirements] * Solo or Team subscription * ServiceM8 account * A supported template and field ## Install from the ServiceM8 Add-on Store [#install-from-the-servicem8-add-on-store] 1. In ServiceM8, open the **Add-on Store** and select **Tradie Forms** 2. Select **Connect** or **Install** 3. Sign in to Tradie Forms, or create an account if you are new 4. If you are on Free, upgrade to **Solo** or **Team** on the activation page 5. Approve the access Tradie Forms requests 6. Return to ServiceM8 or start a form in Tradie Forms The add-on install is free. Importing job details and attaching PDFs requires a **Solo** or **Team** subscription. See [Billing](/docs/account/billing). On a **team workspace**, only a team admin can complete the ServiceM8 connection for the crew. ## Connect ServiceM8 in Tradie Forms [#connect-servicem8-in-tradie-forms] 1. Open [**Connections**](https://tradieforms.com.au/app/integrations) 2. Choose **ServiceM8** 3. Select the access you want 4. Select **Connect with ServiceM8** 5. Sign in to ServiceM8 and approve access The connection is saved to your active workspace. On a team workspace, team admins manage the connection. ## Access options [#access-options] | Option | What it is used for | | ----------------------------------- | ------------------------------------------------------------------------------------------ | | **Import job and customer details** | Job number, job address, site contact, billing contact, customer company, and job category | | **Job schedule** | Scheduled visit start and end | | **Assigned technician** | Staff name and contact details | | **Job notes** | Notes for remarks, access, or job context fields | | **Your business details** | Company name, email, and ABN where supported | | **Upload PDFs to job cards** | Attach completed PDFs back to ServiceM8 | To add access, turn it on and reconnect. To remove access, disconnect and reconnect with fewer options selected. Store installs connect with import and business details by default. Reconnect from Connections to add PDF upload or other optional access. ## Import into a form [#import-into-a-form] ### Per-field import [#per-field-import] 1. Open a supported form while signed in on Solo or Team 2. Select the link icon beside a supported field 3. Search or pick a ServiceM8 job 4. Choose the field value to import 5. Check the result before download Supported values can include job number, site address, customer name, phone, email, billing details, assigned technician, notes, ABN, and business details. Support is field-by-field. If a field can import from ServiceM8, it shows the link icon while you fill the form. ### Connect import mode [#connect-import-mode] On the ServiceM8 integration page, enable **Connect import** to map form fields to ServiceM8 once, then import a whole job in one go. 1. Open a supported form with Connect import enabled 2. Follow the banner to pick a sample job 3. Map each form field to the matching ServiceM8 value 4. Save the mapping for that template 5. On future jobs, pick a job and import all mapped fields together When Connect import is off, use the link icon beside each field instead. ## Attach PDFs to ServiceM8 jobs [#attach-pdfs-to-servicem8-jobs] Enable **Upload PDFs to job cards** when connecting or reconnecting ServiceM8. You can attach PDFs in two ways: * From the **Your PDF is ready** sheet after download, when you imported at least one ServiceM8 field during that session * From **Completed**, using **Send to ServiceM8** If a stored PDF is available (Solo stored copies or Team audit trail), the stored copy can be used. Otherwise Tradie Forms regenerates the PDF from saved form data. ## Platforms and regions [#platforms-and-regions] Tradie Forms runs in your web browser on desktop and mobile. Use it alongside the ServiceM8 Online Dashboard while you fill forms on site. Tradie Forms is not embedded inside the ServiceM8 iOS app. Templates and compliance forms are built for **Australia**. Your ServiceM8 data stays tied to your own account and workspace. ## Disconnect [#disconnect] Open the ServiceM8 integration page and select **Disconnect**. For team workspaces, only team admins can disconnect the shared connection. You can also disable the add-on from the ServiceM8 Add-on Store to revoke access. ## Troubleshooting [#troubleshooting] | Issue | What to do | | ----------------------- | ------------------------------------------------------------------------------------------- | | **Solo required** | Upgrade, then connect again from Connections or the store activation page | | **Team admin required** | Ask a team admin to connect ServiceM8 for your business workspace | | **Connection expired** | Open Connections, then reconnect ServiceM8 | | **Missing access** | Reconnect with the options you need (for example PDF upload) | | **Import icon missing** | Confirm you are on Solo or Team, ServiceM8 is connected, and the form field supports import | Imported job data is a shortcut, not a final check. Confirm all names, addresses, dates, and job details before issuing the PDF.