Skip to main content
POST
Schedule a message

Authorizations

Authorization
string
header
required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, or a member token. The credential alone identifies the member and company.

Path Parameters

id
string<uuid>
required

Public id of a conversation the member can see.

Body

application/json
text
string
required

Required unless the schedule has attachments; it may not be blank.

Required string length: 1 - 10000
Pattern: \S
scheduled_at
string<date-time>
required

A future ISO 8601 timestamp with an explicit UTC offset (Z or +05:45); one without an offset is refused.

theme
string | null
Maximum string length: 255
attachments
object[]

Files the client has uploaded, named by URL, as the legacy schedule endpoint takes them. The URL is not checked as an owned upload.

Maximum array length: 10

Response

The scheduled message.

One scheduled message.

status
integer
required
data
object
required

A message the member scheduled. When delivery claims it, it becomes an ordinary message of the conversation and is no longer listed here.

meta
object
required

Envelope metadata present on every response.