# ServiceM8 API Documentation

This is the complete API documentation for connecting to the ServiceM8 API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **ServiceM8 connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/serviceM8/actions/{actionSlug}/run
```

## ServiceM8 actions

- POST `create-client` Create Client
- POST `create-company-contact` Create Company Contact
- POST `create-job` Create Job
- POST `create-job-activity` Create Job Activity
- POST `create-job-allocation` Create Job Allocation
- POST `create-task` Create Task
- GET `get-client` Get Client
- GET `get-job` Get Job
- GET `get-staff-member` Get Staff Member
- GET `list-clients` List Clients
- GET `list-company-contacts` List Company Contacts
- GET `list-job-activities` List Job Activities
- GET `list-job-allocations` List Job Allocations
- GET `list-jobs` List Jobs
- GET `list-staff-members` List Staff Members
- GET `list-tasks` List Tasks
- PUT `update-client` Update Client
- PUT `update-company-contact` Update Company Contact
- PUT `update-job` Update Job
- PUT `update-job-activity` Update Job Activity
- PUT `update-staff-member` Update Staff Member
- PUT `update-task` Update Task