# ServiceM8 integrations: jobs and job activities

> Create a job, create a job activity and create a company contact in ServiceM8, and start a workflow when ServiceM8 sends “Job changed”.

**Canonical page:** https://tray.ai/connectors/servicem8-integrations/
**Categories:** Operations
**Connects through:** HTTP Connector

## Overview

ServiceM8 is job management software for trades and field service businesses, covering scheduling, quotes, job materials, staff, and client records. Tray.ai connects to ServiceM8 through the HTTP Connector, so your workflows can call the ServiceM8 API alongside the rest of your stack.

## Use cases

### Jobs

Read, create, update, and delete jobs in ServiceM8 from any Tray.ai workflow. The ServiceM8 API covers calls such as list jobs and create a job.

- List jobs
- Create a job
- Get a job

### Job activities

Read, create, update, and delete job activities in ServiceM8 from any Tray.ai workflow. The ServiceM8 API covers calls such as list job activities and create a job activity.

- List job activities
- Create a job activity
- Update a job activity

### Clients

Read, create, and update clients in ServiceM8 from any Tray.ai workflow. The ServiceM8 API covers calls such as list clients and list company contacts.

- List clients
- List company contacts
- Create a company contact

### Materials

Read, create, update, and delete materials in ServiceM8 from any Tray.ai workflow. The ServiceM8 API covers calls such as list materials and create a material.

- List materials
- Create a material
- Update a material

### Staff

Read, create, update, and delete staff in ServiceM8 from any Tray.ai workflow. The ServiceM8 API covers calls such as list staff members and create a staff member.

- List staff members
- Create a staff member
- Update a staff member

### ServiceM8 events

Start a Tray.ai workflow the moment something happens in ServiceM8. ServiceM8 sends events such as job changed and job activity changed to a Tray.ai webhook trigger.

- Job changed
- Job activity changed
- Job payment changed

## Challenges Tray.ai solves

### Keeping ServiceM8 credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store ServiceM8 credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the ServiceM8 API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the ServiceM8 API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to ServiceM8?

Yes. Tray.ai connects to ServiceM8 through the HTTP Connector, which calls the ServiceM8 API directly. Any call the ServiceM8 API documents can run as a step in a Tray.ai workflow.

### How does Tray.ai authenticate with ServiceM8?

The ServiceM8 API uses an API key in a request header and OAuth 2.0. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated ServiceM8 connector?

ServiceM8 runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated ServiceM8 connector from the ServiceM8 API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/
