---
title: "Convert message to job"
method: POST
path: "/inboxmessage/{uuid}/convert-to-job.json"
tags: ["Inbox"]
---

# Convert message to job

`POST /inboxmessage/{uuid}/convert-to-job.json`

## Request

- Base URL: `https://api.servicem8.com/api_1.0`
- URL: `https://api.servicem8.com/api_1.0/inboxmessage/{uuid}/convert-to-job.json`
- Auth: one of:
  - API key in header `X-Api-Key`
  - OAuth 2
    - Authorization code: `https://api.servicem8.com/oauth/authorize`
    - Token URL: `https://api.servicem8.com/oauth/access_token` scopes: `publish_inbox`

Converts an inbox message into a new job, optionally using a job template

## Path parameters

- `uuid` string, uuid, required

## Request body

- ConvertToJobRequest
  - `template_uuid` string, uuid, nullable
  - `note` string, nullable

## Response `201`

Job created successfully

- ConvertToJobResponse
  - `success` boolean
  - `job` object
    - `uuid` string, uuid
    - `id` integer
    - `job_number` string
    - `location` string
  - `message` string

## Changes

- **2026-01-08** `3999cf7e5b40`: 2 info
  - the security scope `publish_inbox` was added to the endpoint's security scheme `oauth2`
  - the security scope `manage_inbox` was removed from the endpoint's security scheme `oauth2`
- **2025-09-23** `5793f2e4c841`: 1 breaking
  - request body became required

[Operation history](https://skmtc.dev/servicem8/apis/servicem8-api/changes/inboxmessage/:uuid/convert-to-job.json/post.md)

---

[API](https://skmtc.dev/servicem8/apis/servicem8-api.md) - [All operations](https://skmtc.dev/servicem8/apis/servicem8-api/llms.txt) - [OpenAPI document](https://skmtc.dev/servicem8/apis/servicem8-api/revisions/53ede60e3653?raw)