POST
Messages.Reply
Save a reply to an existing message when reply is allowed for that message type. After a successful reply the route runs message.replied automation and emits realtime message.replied.
Permissions
- User must be logged in with a valid bearer token.
- Returned or changed records are limited by the user permissions, team access, folder access, and account settings.
Action
- Updates the requested Messages record after validating permissions and input fields.
Push Service
Pushes event message.replied to users who should see this change.
Automation
Runs automation event message.replied with the record id and submitted parameters after the action succeeds.
Special Instructions
- Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
- Send parameters as POST body fields exactly as documented.
Required Parameters
| Name | Type | Sample | Explanation |
|---|---|---|---|
message_idpost | int | 101 | Message being replied to. |
messagepost | string | Thanks. | Reply body. |
Optional Parameters
| Name | Type | Sample | What it gives |
|---|---|---|---|
topost | string | [email protected] | Override recipient when allowed. |
Authentication
Send the bearer token returned by Login in the request header.
Authorization: Bearer YOUR TOKEN
Sample Request
{
"url": "\/app\/Messages.Reply",
"method": "POST",
"headers": {
"Authorization": "Bearer YOUR TOKEN"
},
"body": {
"message_id": "101",
"message": "Thanks."
},
"url_user": "https:\/\/{user}.bull36.com\/app\/Messages.Reply",
"url_domain": "https:\/\/{domain}\/app\/Messages.Reply"
}Endpoint
POST /app/Messages.Reply
POST https://{user}.bull36.com/app/Messages.Reply
POST https://{domain}/app/Messages.ReplySample Output
{
"success": 1,
"message_id": "102",
"reply_to": "101",
"automation_event": "message.replied",
"socket_event": "message.replied"
}JavaScript Example
const token = 'YOUR TOKEN';
const body = new URLSearchParams({ message_id: '101', message: 'Thanks.' });
const res = await fetch('/app/Messages.Reply', { method: 'POST', headers: { Authorization: `Bearer ${token}` }, body });
const data = await res.json();Error Example
{
"success": "0",
"message": "Reply is allowed only for messages with an email recipient."
}