---
title: "Create a new message."
method: POST
path: "/v2/messages"
tags: ["Messages"]
---

# Create a new message.

`POST /v2/messages`

## Request body

- ThreadMessageEditModel
  - `attachment_url` string, nullable — A publicly accessible URL to a file to be attached to the message. Images only. Maximum 5 MB.
  - `body` string, nullable — The message text.
  - `thread_id` integer — The ID of the thread on which this message should be posted.

## Response `200`

A model representing the message created.

- ThreadMessageViewModel
  - `id` integer — The ID of this record.
  - `attachment_urls` string[] — A list of URLs for downloading attachments to this message. URLs are temporary and will expire after a set time.
  - `body` string — The message text.
  - `date_utc` string, date-time — The date this message was sent or received.
  - `from_contact_id` integer — The ID of the guest or contact who wrote this message.
  - `from_role` 'owner' | 'guest' | 'co_host' | 'support' | 'other' | 'cotraveler' | 'third_party_booker' — The role of the contact who wrote a message.
  - `is_draft` boolean — Indicates an unsent draft.
  - `removed_utc` string, date-time, nullable — The date this message was removed.
  - `thread` ThreadPartialModel — Partial details about the thread.
    - `id` integer — The ID of this record.
    - `booking_id` integer, nullable — The ID of the most recent booking associated with this thread, if any.
    - `channel` 'unknown' | 'booking_com' | 'trip_advisor' | 'canada_stays' | 'vrbo' | 'airbnb' | 'florida_rentals' | 'houfy' | 'home_to_go' | 'smoky_mountains' | 'ha_xml_sandbox' | 'find_rentals' | 'guest_smiles' | 'getaway_go_go' | 'whimstay' | 'golightly' | 'ecbyo' | 'google_vacation_rentals' | 'rentalz' | 'savvy' | 'mrbo_and_american_snowbird' | 'ha_xml_sandbox_mo_r' | 'nofie' | 'hopper_homes' | 'book_direct_forgotten_coast' | 'florida_rental_by_owners' | 'got2_go' | 'glamping_hub' | 'local_ota' | 'avanti' | 'stay' | 'crewdogs' | 'lake' | 'wander' | 'vidle_housing' | 'foxhole' | 'travelstaytion' | 'marriott' | 'broken_bow' | 'branson_premier' | 'inhaven' | 'trip_skip' | 'home_away' | 'owner_rez_hosted_site'
    - `inquiry_id` integer, nullable — The ID of the most recent inquiry associated with this thread, if any.
    - `property_id` integer, nullable — The ID of the property associated with this thread, if any.
    - `quote_id` integer, nullable — The ID of the most recent quote associated with this thread, if any.
    - `type` 'channel' | 'sms' | 'email' | 'direct' | 'whats_app'
  - `thread_id` integer — The ID of the thread on which this message was posted.

---

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