Sign in
Staff Messages

Create a new Staff Message

OAuth Scope

This endpoint requires the following OAuth scope publish_messages.

Record UUID

UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the x-record-uuid response header.

post/staffmessage.json

Request body

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

from_staff_uuidstring uuid
to_staff_uuidstring uuid
sent_timestampstring
delivered_timestampstring
read_timestampstring
messagestring
regarding_job_uuidstring uuid
attached_jsonstring

Example request

{
  "uuid": "123e4567-73b8-4a96-8e9e-2331261edb0b",
  "edit_date": "2025-09-01 12:00:00",
  "from_staff_uuid": "123e4567-ef9c-4b75-aff2-233128aee34b",
  "to_staff_uuid": "123e4567-4e21-4cc1-aa1c-23312a9c29eb",
  "sent_timestamp": "2025-09-01 12:00:00",
  "delivered_timestamp": "2025-09-01 12:00:00",
  "read_timestamp": "2025-09-01 12:00:00",
  "regarding_job_uuid": "123e4567-85dd-4e21-8e37-233121e0495b"
}

Response

Success

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes