---
title: "Create a new inbox message"
method: POST
path: "/inboxmessage.json"
tags: ["Inbox"]
---

# Create a new inbox message

`POST /inboxmessage.json`

Creates a new inbox message that will appear in the inbox

## Request body

- CreateInboxMessageRequest
  - `subject` string, required — Subject of the message
  - `message_text` string, required — Plain text content of the message
  - `from_name` string — Name of the sender
  - `from_email` string, email — Email address of the sender
  - `json_data` object — Additional data to be used when converting the message to a job
  - `jobData` object — Structured job data that will be merged into json_data when converting the message to a job
    - `contact_first` string — Job contact first name
    - `contact_last` string — Job contact last name
    - `company_name` string — Company/customer name
    - `email` string, email — Primary email address
    - `mobile` string — Mobile phone number
    - `phone_1` string — Primary phone number
    - `phone_2` string — Secondary phone number
    - `billing_contact_first` string — Billing contact first name
    - `billing_contact_last` string — Billing contact last name
    - `billing_email` string, email — Billing email address
    - `billing_mobile` string — Billing mobile number
    - `billing_attention` string — Billing attention line
    - `job_description` string — Description of the job/work to be done
    - `job_address` string — Service location address
    - `billing_address` string — Billing address
    - `work_done_description` string — Description of completed work
  - `regarding_company_uuid` string, uuid — UUID of the company this message is regarding

## Response `201`

Message created successfully

- InboxMessageDetail
  - `uuid` string, uuid
  - `active` boolean
  - `edit_date` string, date-time
  - `timestamp` string, date-time
  - `read_timestamp` string, date-time, nullable
  - `last_reply_timestamp` string, date-time, nullable
  - `snooze_until_timestamp` string, date-time, nullable
  - `read_by_staff_uuid` string, uuid, nullable
  - `from_name` string
  - `from_email` string
  - `to_email` string
  - `subject` string
  - `message_text` string
  - `message_html` string
  - `is_archived` boolean
  - `archived_timestamp` string, date-time, nullable
  - `archived_by_staff_uuid` string, uuid, nullable
  - `regarding_company_uuid` string, uuid, nullable
  - `converted_to_job_uuid` string, uuid, nullable
  - `job_template_uuid` string, uuid, nullable
  - `message_type` 'email' | 'sms' | 'online_booking' | 'phone_call' | 'reminder' | 'form' | 'network_request' | 'supplier_invoice' | 'asset' | 'partner_lead' | 'automation'

## Other responses

- `400` — Bad request - Invalid input
- `403` — Forbidden - Missing permission or OAuth scope
- `404` — Not found - Related entity not found
- `500` — Internal server error

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/versions/53ede60e3653/schema)