EmailMessage
EmailMessage represents an email message object within the system.
Supported API Calls: Get | Add | Update | Delete | SendEmailMessage
Object Properties
Property |
Type |
Description |
Id |
integer |
A unique Id value for the email object. |
ParentId |
integer |
ParentID is the id of the parent record (e.g., a lead, a contact, etc.). This value is optional. |
ParentObject |
string (100) |
ParentObject identifies what kind of object the email object is a child of. Values are lead, account (if it's an organization), contact, opportunity, project, case. |
FromAddress |
string (100) |
The email that would appear in the from field. |
FromName |
string (100) |
The name of the sender. |
ToAddress |
string (100) |
The email of the recipient. Comma separate multiple addresses. For example: me@me.com,him@him.com |
CcAddress |
string (100) |
Any CC emails. |
BccAddress |
string (100) |
Any Bcc emails. |
Subject |
string (100) |
The email's subject. |
HtmlBody |
string (100) |
The body of the email. |
IsIncoming |
boolean |
Indicates if the email coming into BlueCamroo. |
IsSend |
boolean |
Indicates if the email has been sent out from BlueCamroo. |
MessageDate |
DateTime |
The email's sent time or arrival time. This is optional. This cannot be modified. It is read only. |
OwnerId |
integer |
The ID of the internal user who owns the email object. |
AttachmentList |
List<AttachmentAssociate> |
A list of any attachment objects. |
RecipientList |
List<EmailMessageRecipient> |
List of recipients. |
Get
Description
Returns a message.
URL
https://{company}.bluecamroo.com/api/emailmessage/get/{id}
HTTP Method
GET
Parameters
None
Data Return
Returns the email object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Add
Description
Adds the email message object to your list of email messages. Add does not send an email.
URL
https://{company}.bluecamroo.com/api/emailmessage/add
HTTP Method
POST
Parameters
An emailmessage object
Data Return
Returns the emailmessage object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
201: Created
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Update
Description
Pass an email message object to replace the specified email message.
URL
https://{company}.bluecamroo.com/api/emailmessage/update
HTTP Method
PUT
Parameters
An emailmessage object
Data Return
Returns the emailmessage object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Delete
Description
Deletes the specified email message.
URL
https://{company}.bluecamroo.com/api/emailmessage/delete/{id}
HTTP Method
DELETE
Parameters
None
Data Return
None
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Send
Description
Sends an email message
URL
https://{company}.bluecamroo.com/api/emailmessage/emailmessage/send
HTTP Method
POST
Object Properties
An emailmessage object
Data Return
Returns the emailmessage in the requested format (e.g., JSON or XML)
HTTP Return Status Code
201: Created
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)