Skip to main content
POST
Add a message to a ticket

Authorizations

Authorization
string
header
required

API key from your account settings

Path Parameters

agentId
string
required

The agent ID

Minimum string length: 1
Example:

"5QHA6VB-DIAbBhxwqxfdi"

ticketNumber
integer
required

The ticket number

Required range: x <= 2147483647
Example:

123

Body

application/json
type
enum<string>
required

Message type. Only reply (customer-visible, delivered to the customer) is supported.

Available options:
reply
Example:

"reply"

content
string
required

Message body as GitHub-flavored Markdown. Plain text is valid markdown; single newlines are kept as line breaks. Raw inline HTML is stripped. Limited to 10,000 characters after trimming.

Required string length: 1 - 10000
Example:

"Thanks for reaching out. This is **fixed** now."

authorId
string<uuid>

Platform user id of the team member the reply is attributed to. Provide exactly one of authorId / authorEmail.

authorEmail
string<email>

Email of the team member the reply is attributed to (case-insensitive). Provide exactly one of authorId / authorEmail.

Example:

"sam@example.com"

Response

The created message

id
string
required

Message id

type
enum<string>
required

Message type

Available options:
reply
Example:

"reply"

sender
object | null
required

The team member the reply is attributed to

content
string
required

Rendered, sanitized HTML body

contentText
string
required

The raw markdown body as submitted

createdAt
string
required

ISO 8601 creation timestamp

Example:

"2026-07-29T09:00:00.000Z"