Create a ticket message

post

https://api.heymantle.com/v1/tickets/{id}/messages

Create a new message for a ticket. External images in HTML/markdown content will be automatically downloaded and uploaded to Mantle's CDN.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The ticket ID

Body Params

actorType

string

enum

Defaults to system

The type of actor who sent the message

Allowed:

content

string

Message content (required, defaults to a single space if empty)

fullContent

string

Full message content (for long messages)

contentType

string

enum

Defaults to text

The format of the message content

Allowed:

isInternal

boolean

Defaults to false

Whether this is an internal note

contactId

string

ID of the contact (required if actorType is 'customer')

agentId

string

ID of the agent (required if actorType is 'agent')

occurredAt

date-time

When the message was sent (defaults to now)

messageId

string

RFC-5322 Message-ID header for email threading

inReplyToId

string

RFC-5322 In-Reply-To header for email threading

referencesIds

array of strings

RFC-5322 References header for email threading

referencesIds

attachments

array of objects

attachments

contact

object

Contact object to upsert (if contactId not provided)

send

boolean

Defaults to false

When true, the message is processed as a real reply
would be: configured automations, notifications, and (for
agent actor) outbound delivery run. agentId is required
when actorType: agent. When false (or omitted), the
message is persisted without triggering any side effects.

Responses

201The created ticket message.

400Invalid request (e.g., missing required fields, invalid actorType).

401Unauthorized

403Forbidden

404Ticket not found