Get professional assistance from
a local partner
Contact Me
Recent Updates

API | SDK: Search, Job Template Creation & Inbox Management Endpoints

July 2025

Enhanced API capabilities for developers

ServiceM8's API now includes three major new endpoint categories that significantly expand integration possibilities. These updates address key developer needs for search functionality, streamlined job creation, and comprehensive inbox management.

New Search API Endpoints

You can now implement powerful search functionality across your ServiceM8 data:

  • General Search (/api_1.0/search.json) - Search across multiple object types including jobs, companies, and materials with text-based queries that return sorted results by relevance
  • Object-Specific Search (/reference/objectsearch) - Perform targeted searches within specific object types with narrowed filters for more precision
  • Semantic Job Search (/reference/jobembeddingsearch) - AI-powered endpoint that uses embeddings for natural language queries, returning combined, relevance-sorted results across different data types

Job Creation from Templates

Template-based job creation streamlines workflow automation through a new endpoint:

  • Template-Based Job Creation (/api_1.0/jobtemplate/{uuid}/job.json) - POST endpoint that creates new jobs from existing templates
  • Automatically clones tasks, materials, checklists, quotes, and custom fields from the template
  • Supports field overrides for job_description, company_uuid, and job_address
  • Requires manage_jobs OAuth scope for access

Inbox API Management

Complete inbox message management capabilities are now available through the API:

  • Message Management (/api_1.0/inboxmessage.json) - Full CRUD operations for inbox messages including mark as read, archive/unarchive, and snooze/unsnooze functions
  • Job Integration - Convert inbox messages directly to jobs or attach them to existing jobs, with the ability to add notes for better communication tracking
  • Paginated Listing - Retrieve inbox messages with filtering options for efficient message management

Simplified Job Creation

Standard job creation is now more streamlined:

  • Company UUID field is now optional, reducing the number of required API calls
  • No longer need to create company records before job creation
  • Simplified workflow reduces complexity for developers

Current Job Creation Options

With these updates, you now have three ways to create jobs through the API:

  1. Standard Job Creation (POST /api_1.0/job.json) - Create jobs with minimal required fields
  2. Template-Based Creation (POST /api_1.0/jobtemplate/{uuid}/job.json) - Clone existing templates to create jobs with pre-filled fields and configurations
  3. Inbox Message Conversion (POST /api_1.0/inboxmessage/{uuid}/convert-to-job.json) - Convert an existing inbox message into a job for immediate follow-up
Note: Full API documentation is available at developer.servicem8.com/reference. OAuth scope requirements apply for job template endpoints (manage_jobs scope required).