A representation of a platform-related email.
bodyHtml | string or null The mailing's custom email body, represented in HTML. If provided this field will override any associated template. |
bodyText | string or null The plain-text representation of the 'bodyHTML' field. |
bouncedAt | string or null <date-time>
The date and time the email was bounced. |
clickCount | integer or null The total number of times links within the email were clicked (if the message is tracking links). |
clickedAt | string or null <date-time>
The most recent date and time a link was clicked (if the message is tracking links). |
createdAt | string or null <date-time>
The date and time the mailing was created. |
deliveredAt | string or null <date-time>
The date and time the email was delivered. |
errorBacktrace | string or null Technical details explaining the mailing's error. |
errorReason | string or null <= 255 characters A summary explaining the mailing's error. |
followUpTaskScheduledAt | string or null <date-time> The date and time of when a follow-up task should be due for this mailing. |
followUpTaskType | string or null <= 255 characters The type of follow-up task to create. Possible values are 'follow_up' or 'no_reply'. |
mailboxAddress | string or null The email address the mailing was sent from. |
mailingType | string or null <= 255 characters
A description of the type of the emailing (e.g. "sequence", "single", "campaign"). |
markedAsSpamAt | string or null <date-time> The date and time the email was marked as spam. |
messageId | string or null <= 255 characters
The MIME content Message-ID of the delivered message. |
notifyThreadCondition | string or null <= 255 characters The condition of when to bump this mailing to the top of the user's inbox. Possible values are 'always' or 'no_reply'. |
notifyThreadScheduledAt | string or null <date-time>
The date and time of when this mailing should be bumped to the top of the user's inbox. |
notifyThreadStatus | string or null <= 255 characters
The status of the bump. Possible values are 'pending', 'sent' or 'skipped'. |
openCount | integer or null The total number of times the email was opened (if the message is tracking opens). |
openedAt | string or null <date-time>
The most recent date and time the email was opened (if the message is tracking opens). |
overrideSafetySettings | boolean or null A boolean value whether users can override submission if template variables have not all been replaced. |
references | Array of strings or null A list of references for the mailing taken from the email header. |
repliedAt | string or null <date-time>
The date and time the email was replied to. |
retryAt | string or null <date-time>
The date and time the email will rety to send. |
retryCount | integer or null The number of times the email has been retried to send. |
retryInterval | integer or null The amount of time in seconds between retry attempts. |
scheduledAt | string or null <date-time>
The date and time the email is scheduled to send. |
state | string or null <= 255 characters
The current state of the mailing. Can be 'bounced', 'delivered', 'delivering', 'drafted', 'failed', 'opened', 'placeholder', 'queued', 'replied', or 'scheduled'. |
stateChangedAt | string or null <date-time>
The date and time the state last changed. |
subject | string or null The subject line of the email. |
trackLinks | boolean or null A boolean value whether the mailing is tracking link clicks. |
trackOpens | boolean or null A boolean value whether the mailing is tracking email opens. |
unsubscribedAt | string or null <date-time>
The date and time the recepient unsubscribed from the mailing's sequence. |
updatedAt | string or null <date-time>
The date and time the mailing was last updated. |
{- "bodyHtml": "string",
- "bodyText": "string",
- "bouncedAt": "2019-08-24T14:15:22Z",
- "clickCount": 0,
- "clickedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "deliveredAt": "2019-08-24T14:15:22Z",
- "errorBacktrace": "string",
- "errorReason": "string",
- "followUpTaskScheduledAt": "2019-08-24T14:15:22Z",
- "followUpTaskType": "string",
- "mailboxAddress": "string",
- "mailingType": "string",
- "markedAsSpamAt": "2019-08-24T14:15:22Z",
- "messageId": "string",
- "notifyThreadCondition": "string",
- "notifyThreadScheduledAt": "2019-08-24T14:15:22Z",
- "notifyThreadStatus": "string",
- "openCount": 0,
- "openedAt": "2019-08-24T14:15:22Z",
- "overrideSafetySettings": true,
- "references": [
- "string"
], - "repliedAt": "2019-08-24T14:15:22Z",
- "retryAt": "2019-08-24T14:15:22Z",
- "retryCount": 0,
- "retryInterval": 0,
- "scheduledAt": "2019-08-24T14:15:22Z",
- "state": "string",
- "stateChangedAt": "2019-08-24T14:15:22Z",
- "subject": "string",
- "trackLinks": true,
- "trackOpens": true,
- "unsubscribedAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
object All attachments attached to this mailing. | |
object The calendar associated with any event invites contained in this mailing. | |
object The followup sequence associated with this mailing. You can use only the attribute id to filter mailings by followUpSequence (e.g. filter[followUpSequence][id]=X). | |
object The mailbox associated with this mailing. You can use only the attribute id to filter mailings by mailbox (e.g. filter[mailbox][id]=X). | |
object The associated opportunity. You can use only the attribute id to filter mailings by opportunity (e.g. filter[opportunity][id]=X). | |
object The prospect associated with this mailing. You can use only the attribute id to filter mailings by prospect (e.g. filter[prospect][id]=X). | |
object Recipients of the mailing. Relationship recipients cannot be used as a filter. | |
object | |
object The associated sequence. You can use only the attribute id to filter mailings by sequence (e.g. filter[sequence][id]=X). | |
object The associated sequence state. You can use only the attribute id to filter mailings by sequenceState (e.g. filter[sequenceState][id]=X). | |
object The associated sequence step. You can use only the attribute id to filter mailings by sequenceStep (e.g. filter[sequenceStep][id]=X). | |
object The task this mailing will or did complete upon sending. You can use only the attribute id to filter mailings by task (e.g. filter[task][id]=X). | |
object All tasks associated with this mailing, such as a follow-up task. Relationship tasks cannot be used as a filter. | |
object The template associated with this mailing. You can use only the attribute id to filter mailings by template (e.g. filter[template][id]=X). | |
object The user associated with this mailing. You can use only the attribute id to filter mailings by user (e.g. filter[user][id]=X). |
{- "attachments": {
- "data": [
- {
- "id": 0,
- "type": "attachment"
}
],
}, - "followUpSequence": {
- "data": {
- "id": 0,
- "type": "sequence"
},
}, - "opportunity": {
- "data": {
- "id": 0,
- "type": "opportunity"
},
}, - "sequenceState": {
- "data": {
- "id": 0,
- "type": "sequenceState"
},
}, - "sequenceStep": {
- "data": {
- "id": 0,
- "type": "sequenceStep"
},
},
}
METADATA NAME | DESCRIPTION | QUERY PARAM |
---|---|---|
canWrite | A boolean value indicating whether the current API user has write access to this resource. | provideAuthorizationMeta |
dataConnections | The set of connections a given Mailing has to external sources. | provideDataConnections |
OK
JSON error message
{- "data": [
- {
- "attributes": {
- "bodyHtml": "string",
- "bodyText": "string",
- "bouncedAt": "2019-08-24T14:15:22Z",
- "clickCount": 0,
- "clickedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "deliveredAt": "2019-08-24T14:15:22Z",
- "errorBacktrace": "string",
- "errorReason": "string",
- "followUpTaskScheduledAt": "2019-08-24T14:15:22Z",
- "followUpTaskType": "string",
- "mailboxAddress": "string",
- "mailingType": "string",
- "markedAsSpamAt": "2019-08-24T14:15:22Z",
- "messageId": "string",
- "notifyThreadCondition": "string",
- "notifyThreadScheduledAt": "2019-08-24T14:15:22Z",
- "notifyThreadStatus": "string",
- "openCount": 0,
- "openedAt": "2019-08-24T14:15:22Z",
- "overrideSafetySettings": true,
- "references": [
- "string"
], - "repliedAt": "2019-08-24T14:15:22Z",
- "retryAt": "2019-08-24T14:15:22Z",
- "retryCount": 0,
- "retryInterval": 0,
- "scheduledAt": "2019-08-24T14:15:22Z",
- "state": "string",
- "stateChangedAt": "2019-08-24T14:15:22Z",
- "subject": "string",
- "trackLinks": true,
- "trackOpens": true,
- "unsubscribedAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "id": 0,
- "relationships": {
- "attachments": {
- "data": [
- {
- "id": 0,
- "type": "attachment"
}
],
}, - "followUpSequence": {
- "data": {
- "id": 0,
- "type": "sequence"
},
}, - "opportunity": {
- "data": {
- "id": 0,
- "type": "opportunity"
},
}, - "sequenceState": {
- "data": {
- "id": 0,
- "type": "sequenceState"
},
}, - "sequenceStep": {
- "data": {
- "id": 0,
- "type": "sequenceStep"
},
},
}, - "type": "string"
}
]
}
object |
Created
JSON error message
{- "data": {
- "attributes": {
- "bodyHtml": "string",
- "bodyText": "string",
- "bouncedAt": "2019-08-24T14:15:22Z",
- "clickCount": 0,
- "clickedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "deliveredAt": "2019-08-24T14:15:22Z",
- "errorBacktrace": "string",
- "errorReason": "string",
- "followUpTaskScheduledAt": "2019-08-24T14:15:22Z",
- "followUpTaskType": "string",
- "mailboxAddress": "string",
- "mailingType": "string",
- "markedAsSpamAt": "2019-08-24T14:15:22Z",
- "messageId": "string",
- "notifyThreadCondition": "string",
- "notifyThreadScheduledAt": "2019-08-24T14:15:22Z",
- "notifyThreadStatus": "string",
- "openCount": 0,
- "openedAt": "2019-08-24T14:15:22Z",
- "overrideSafetySettings": true,
- "references": [
- "string"
], - "repliedAt": "2019-08-24T14:15:22Z",
- "retryAt": "2019-08-24T14:15:22Z",
- "retryCount": 0,
- "retryInterval": 0,
- "scheduledAt": "2019-08-24T14:15:22Z",
- "state": "string",
- "stateChangedAt": "2019-08-24T14:15:22Z",
- "subject": "string",
- "trackLinks": true,
- "trackOpens": true,
- "unsubscribedAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "relationships": {
- "attachments": {
- "data": [
- {
- "id": 0,
- "type": "attachment"
}
],
}, - "followUpSequence": {
- "data": {
- "id": 0,
- "type": "sequence"
},
}, - "opportunity": {
- "data": {
- "id": 0,
- "type": "opportunity"
},
}, - "sequenceState": {
- "data": {
- "id": 0,
- "type": "sequenceState"
},
}, - "sequenceStep": {
- "data": {
- "id": 0,
- "type": "sequenceStep"
},
},
}, - "type": "string"
}
}
{- "data": {
- "attributes": {
- "bodyHtml": "string",
- "bodyText": "string",
- "bouncedAt": "2019-08-24T14:15:22Z",
- "clickCount": 0,
- "clickedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "deliveredAt": "2019-08-24T14:15:22Z",
- "errorBacktrace": "string",
- "errorReason": "string",
- "followUpTaskScheduledAt": "2019-08-24T14:15:22Z",
- "followUpTaskType": "string",
- "mailboxAddress": "string",
- "mailingType": "string",
- "markedAsSpamAt": "2019-08-24T14:15:22Z",
- "messageId": "string",
- "notifyThreadCondition": "string",
- "notifyThreadScheduledAt": "2019-08-24T14:15:22Z",
- "notifyThreadStatus": "string",
- "openCount": 0,
- "openedAt": "2019-08-24T14:15:22Z",
- "overrideSafetySettings": true,
- "references": [
- "string"
], - "repliedAt": "2019-08-24T14:15:22Z",
- "retryAt": "2019-08-24T14:15:22Z",
- "retryCount": 0,
- "retryInterval": 0,
- "scheduledAt": "2019-08-24T14:15:22Z",
- "state": "string",
- "stateChangedAt": "2019-08-24T14:15:22Z",
- "subject": "string",
- "trackLinks": true,
- "trackOpens": true,
- "unsubscribedAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "id": 0,
- "relationships": {
- "attachments": {
- "data": [
- {
- "id": 0,
- "type": "attachment"
}
],
}, - "followUpSequence": {
- "data": {
- "id": 0,
- "type": "sequence"
},
}, - "opportunity": {
- "data": {
- "id": 0,
- "type": "opportunity"
},
}, - "sequenceState": {
- "data": {
- "id": 0,
- "type": "sequenceState"
},
}, - "sequenceStep": {
- "data": {
- "id": 0,
- "type": "sequenceStep"
},
},
}, - "type": "string"
}
}
{- "data": {
- "attributes": {
- "bodyHtml": "string",
- "bodyText": "string",
- "bouncedAt": "2019-08-24T14:15:22Z",
- "clickCount": 0,
- "clickedAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "deliveredAt": "2019-08-24T14:15:22Z",
- "errorBacktrace": "string",
- "errorReason": "string",
- "followUpTaskScheduledAt": "2019-08-24T14:15:22Z",
- "followUpTaskType": "string",
- "mailboxAddress": "string",
- "mailingType": "string",
- "markedAsSpamAt": "2019-08-24T14:15:22Z",
- "messageId": "string",
- "notifyThreadCondition": "string",
- "notifyThreadScheduledAt": "2019-08-24T14:15:22Z",
- "notifyThreadStatus": "string",
- "openCount": 0,
- "openedAt": "2019-08-24T14:15:22Z",
- "overrideSafetySettings": true,
- "references": [
- "string"
], - "repliedAt": "2019-08-24T14:15:22Z",
- "retryAt": "2019-08-24T14:15:22Z",
- "retryCount": 0,
- "retryInterval": 0,
- "scheduledAt": "2019-08-24T14:15:22Z",
- "state": "string",
- "stateChangedAt": "2019-08-24T14:15:22Z",
- "subject": "string",
- "trackLinks": true,
- "trackOpens": true,
- "unsubscribedAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}, - "id": 0,
- "relationships": {
- "attachments": {
- "data": [
- {
- "id": 0,
- "type": "attachment"
}
],
}, - "followUpSequence": {
- "data": {
- "id": 0,
- "type": "sequence"
},
}, - "opportunity": {
- "data": {
- "id": 0,
- "type": "opportunity"
},
}, - "sequenceState": {
- "data": {
- "id": 0,
- "type": "sequenceState"
},
}, - "sequenceStep": {
- "data": {
- "id": 0,
- "type": "sequenceStep"
},
},
}, - "type": "string"
}
}