Message
A message record exposes a message to REST web services.
This record has the following subrecords:
-
MessageFile
-
CcBccRecipient
The REST API Browser includes information about the field names and field types of the message record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s message reference page.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for the message REST record is Message.
Exposed Elements
The following message record elements are exposed to REST web services:
-
activity
-
author
-
authoremail
-
bcc
-
cc
-
emailed
-
entity
-
externalid
-
hasattachment
-
htmlmessage
-
id
-
incoming
-
lastmodifieddate
-
message
-
messagedate
-
recipient
-
recipientemail
-
record
-
recordtype
-
subject
-
template
-
time
-
transaction
Usage Notes
All fields are read-only.
Code Sample
In the following example, <accountID>
represents your account ID.
HTTP request: https://<accountID>/services/rest/record/v1/message
Request Body
{ "subject": "Meeting agenda", "message": "Please send the agenda for tomorrow's meeting.", "author": "-5", "authorEmail": "sender@your.example.com", "recipientEmail": "recipient@your.example.com", "cc": "cc_recipient@your.example.com", "bcc": "bcc_recipient@your.example.com"
}
To Obtain Previously-Created Message Record (where ID is 230)
HTTP Method: GET
URL: https://<accountID>/services/rest/record/v1/message/230
Response Body
{ "links": [ { "rel": "self", "href": http://<accountID>/services/rest/record/v1/message/230 } ], "author": { "links": [ { "rel": "self", "href": http://<accountID>/services/rest/record/v1/customer/-5 } ], "id": "-5", "refName": "A Wolfe-admin" }, "authorEmail": "sender@your.example.com", "bcc": "bcc_recipient@your.example.com", "cc": "cc_recipient@your.example.com", "emailed": true, "hasAttachment": false, "htmlMessage": true, "htmlMessage": true, "id": "230", "incoming": true, "lastModifiedDate": "2020-11-25T16:32:00Z", "message": "Please send the agenda for tomorrow's meeting.", "messageDate": "2020-11-25", "recipient": { "links": [ { "rel": "self", "href": "<accountID>/services/rest/record/v1/customer/-5" } ], "id": "-5", "refName": "A Wolfe-admin" }, "recipientEmail": "recipient@your.example.com", "subject": "Meeting agenda", "time": "08:32"
}