EmailModel
An Email represents a communication sent from one company to another. The creator of the email is identified
by the CompanyId
field, recipient(s) by the EmailTo
field, and cc recipient(s) by the 'EmailCC' field.
The Email Model represents an email and a number of different metadata attributes related to the creation,
storage, and ownership of the email.
Methods
The following API methods use this data model.
Read-Only Fields
These fields are assigned by the API server and cannot be changed.
emailId
uuid, read-only
The unique ID of this record, automatically assigned by Lockstep when this record is
added to the Lockstep platform.
groupKey
uuid, read-only
The GroupKey uniquely identifies a single Lockstep Platform account. All records for this
account will share the same GroupKey value. GroupKey values cannot be changed once created.
For more information, see Accounts and GroupKeys.
created
date-time, read-only
The date on which this email was created.
createdUserId
uuid, read-only
The ID number of the user who created this email.
appEnrollmentId
uuid, nullable, read-only
The AppEnrollmentId of the application that imported this record. For accounts
with more than one financial system connected, this field identifies the originating
financial system that produced this record. This value is null if this record
was not loaded from an external ERP or financial system.
modified
date-time, read-only
The date on which this email was modified.
Email modification should only be done by internal services.
modifiedUserId
uuid, read-only
The ID of the user who modified this email.
Email modification should only be done by internal services.
responseOrigin
EmailModel, nullable, read-only
The email object associated with the response origin id.
Required Fields
threadId
The unique ID number of this email's conversation thread.
isUnread
A status flag indicating if this email is unread.
isPriority
A status flag indicating if this email is priority status.
isSpam
A status flag indicating if this email is marked as spam.
toBeSent
A status flag indicating if this email is to be sent.
viewCount
The number of times this email was viewed.
Optional Fields
companyId
uuid, nullable
The ID number of the company that created this email.
emailFrom
string, nullable, 0-200 characters
The email address for the sender of this email.
emailTo
string, nullable, 0-1000 characters
The email address for the recipient(s) of this email.
emailCC
string, nullable, 0-1000 characters
The email address for the CC recipient(s) of this email
emailSubject
string, nullable, 0-998 characters
The subject line of this email.
emailBody
string, nullable
The body content of this email.
sentDate
date-time, nullable
The date on which this email was sent.
customerId
uuid, nullable
The ID number of the customer that sent this email.
receivedTimeStamp
date-time, nullable
The date on which this email was received.
openedTimestamp
date-time, nullable
The date on which this email was opened.
externalEmailId
string, nullable, 0-250 characters
The id of the email in an external system if imported.
externalThreadId
string, nullable, 0-250 characters
The id of the email thread in an external system if imported.
emailBcc
string, nullable, 0-1000 characters
The email address(es) for the BCC recipient(s) of this email
sendType
string, nullable, 0-7 characters
The type message being sent (New, Reply, Forward) or null for messages not being sent.
responseOriginId
uuid, nullable
If the message being sent is a reply or a forward, the id of the the email being replied to or forwarded.
Otherwise null.
Included Collections
These fields are available when using Retrieve or Query API calls if you specify the associated Include
parameter.
notes
NoteModel[], nullable, read-only
A collection of notes linked to this record. To retrieve this collection, specify Notes
in the
include
parameter when retrieving data.
To create a note, use the Create Note
endpoint with the TableKey
to Email
and the ObjectKey
set to the EmailId
for this record. For
more information on extensibility, see linking extensible metadata to objects.
attachments
AttachmentModel[], nullable, read-only
A collection of attachments linked to this record. To retrieve this collection, specify Attachments
in
the include
parameter when retrieving data.
To create an attachment, use the Upload Attachment
endpoint with the TableKey
to Email
and the ObjectKey
set to the EmailId
for this record. For
more information on extensibility, see linking extensible metadata to objects.
customFieldDefinitions
CustomFieldDefinitionModel[], nullable, read-only
A collection of custom fields linked to this record. To retrieve this collection, specify
CustomFieldDefinitions
in the include
parameter when retrieving data.
To create a custom field, use the Create Custom Field
endpoint with the TableKey
to Email
and the ObjectKey
set to the EmailId
for this record. For
more information on extensibility, see linking extensible metadata to objects.
customFieldValues
CustomFieldValueModel[], nullable, read-only
A collection of custom fields linked to this record. To retrieve this collection, specify
CustomFieldValues
in the include
parameter when retrieving data.
To create a custom field, use the Create Custom Field
endpoint with the TableKey
to Email
and the ObjectKey
set to the EmailId
for this record. For
more information on extensibility, see linking extensible metadata to objects.
Updated about 2 months ago