OWownerrez
Messages

Create a new message.

Changed on

OAuth app required. Personal Access Tokens can't call messaging endpoints. Using your own account? Create an OAuth app and click Grant Access To Me — that's it. Third-party apps need a signed messaging agreement (email partnerhelp@ownerrez.com with the subject Messaging API Access). Otherwise every call returns 402 messaging_not_enabled.

post/v2/messages

Request

  • Base URL
    https://api.ownerrez.com
  • URL
    https://api.ownerrez.com/v2/messages
  • Auth
    • HTTP bearer
    • or HTTP basic

Request body

attachment_urlstring nullable

A publicly accessible URL to a file to be attached to the message. Images only. Maximum 5 MB.

bodystring nullable

The message text.

thread_idinteger

The ID of the thread on which this message should be posted.

Response

A model representing the message created.

idinteger

The ID of this record.

attachment_urlsstring[]

A list of URLs for downloading attachments to this message. URLs are temporary and will expire after a set time.

bodystring

The message text.

date_utcstring date-time

The date this message was sent or received.

from_contact_idinteger

The ID of the guest or contact who wrote this message.

from_role'owner' | 'guest' | 'co_host' | 'support' | 'other' | 'cotraveler' | 'third_party_booker' | 'bot'

The role of the contact who wrote a message.

is_draftboolean

Indicates an unsent draft.

removed_utcstring date-time nullable

The date this message was removed.

thread_idinteger

The ID of the thread on which this message was posted.

Changes

  • 38121ad2fc9fRevision changes
    • warning

      added the new nalren enum value to the /// response property for the response status

  • d5fd391b16c8Revision changes
    • warning

      added the new broken_bow_stays enum value to the /// response property for the response status