recentActivityObject

The recentActivityObject contains activity data for an account.

Name Type Description
createdDate dateTime The date the activity was recorded.
contactId string The ID assigned to the contact associated with the activity.
listId string The ID assigned to the list that the delivery associated with the activity was sent to.
segmentId string The ID assigned to the segment that the delivery associated with the activity was sent to.
keywordId string The ID assigned to the SMS keyword that the SMS delivery associated with the activity was sent to.
messageId string The ID assigned to the message associated with the activity.
deliveryId string The ID assigned to the delivery associated with the activity.
workflowId string The ID assigned to the workflow that sent the delivery associated with the activity.
activityType string

The type of activity the object represents. The activityType can be:

Inbound Activities:

  • bounce
  • click
  • contactSkip
  • conversion
  • friendforward
  • open
  • reply
  • sms_reply
  • sms_bounce
  • social
  • unsubscribe
  • webform

Outbound Activities:

  • send
  • sms_send
emailAddress string The email address of the contact associated with the activity. The emailAddress li is returned if a contactId is returned, and an email address is stored for the associated contact.
mobileNumber string The mobile number of the contact associated with the activity. The mobileNumber li is returned if a contactId is returned, and a mobile number is stored for the associated contact.
contactStatus string

The status of the contact associated with the activity. Each valid status is described below:

  • active – Active contacts are “live” contacts that can receive both marketing and transactional emails from you.
  • onboarding – Onboarding contacts are new contacts who are waiting to be sent their first marketing email from you. Once they are sent the first marketing email, they will enter the assessment phase of the automated onboarding process and automatically move from onboarding to Awaiting Assessment, and then to active. You can not update a contact’s status if they currently have a status of onboarding. Contacts with a status of onboarding can receive transactional emails from you.
  • transactional – Contacts with a status of transactional can only be sent transactional emails. A transactional email facilitates an agreed-upon transaction, or updates a customer in an existing business relationship.
  • bounce – The bounce contact status indicates that you cannot send messages to this contact because they have received a hard bounce due to bad email address, or they have exceed the bounce limit for your account.
  • unconfirmed – Contacts with a status of unconfirmed have not yet agreed to receive your marketing email messages. Remember, one of our policies is that contacts must agree to receive your marketing email messages in order for you to send marketing emails to them. Contacts with a status of unconfirmed can receive transactional emails from you.
  • unsub – Contacts with this status have either unsubscribed themselves from receiving marketing email messages from you, or were unsubscribed by you. These contacts can receive transactional emails from you.

The status li is returned if a contactId is returned.

messageName string The name of the message associated with the activity. The messageName li is returned if a messageId is returned
deliveryType string

The type of delivery associated with the activity:

  • bulk – Regular email deliveries sent via the application and from single sends using workflows.
  • test – A test delivery.
  • automator – A delivery sent via an Automator or Automated Message Rule.
  • split – A delivery made as part of an A/B split test.
  • transaction: Transactional delivery
  • trigger: API triggered delivery.
  • ftaf: Forward To A Friend delivery.

The deliveryType li is returned if a deliveryId is returned.

deliveryStart dateTime The date/time the delivery associated with the activity was scheduled. The deliveryStart li is returned if a deliveryId is returned.
workflowName string The name of the workflow associated with the activity. The workflowName li is returned if a workflowId is returned.
segmentName string The name of the segment associated with the activity. The segmentName li is returned if a segmentId is returned.
listName string The name of the list associated with the activity. The listName li is returned if a listId is returned.
listLabel string The label assigned to the list associated with the activity. The label is the external (customer facing) name given to a list. The listLabel li is returned if a listId is returned.
automatorName string The name of the automator associated with the activity.
smsKeywordName string The name of the SMS keyword associated with the activity. The smsKeywordName li is returned if a keywordId is returned.
bounceType string

The type of bounce recorded. The following types can be returned:

Hard Bounces

  • bad_email
  • destination_unreachable
  • rejected_message_content

Soft Bounces

  • temporary_contact_issue
  • destination_temporarily_unavailable
  • deferred_message_content
  • unclassified

The bounceType li is returned if the activityType is bounce.

bounceReason string The detailed reason why the bounce occurred. The bounceReason li is returned if the activityTypeis bounce.
skipReason string The detailed reason why the contact was skipped when attempting to send to them. The skipReasonli is returned if the activityType is contactSkip.
linkName string The name of the link that was clicked. The linkNameli is returned if the activityType is click.
linkUrl string The URL of the link that was clicked. The linkUrlli is returned if the activityType is click.
orderId string The ID assigned to the order. The orderId li is returned if the activityType is conversion.
unsubscribeMethod string

The method used by the contact to unsubscribe. Valid values are:

  • subscriber
  • admin
  • bulk
  • listcleaning
  • fbl (Feedback Loop)
  • complaint
  • account
  • api
  • unclassified

The unsubscribeMethod li is returned if the activityType is unsubscribe.

ftafEmails string The emails that were used in the Forward To A Friend Delivery. The ftafEmails li is returned if the activityType is friendforward.
socialNetwork string

The social network the activity was performed on. The valid networks are:

  • facebook
  • twitter
  • linkedin
  • digg
  • myspace

The bounceType li is returned if the activityType is social.

socialActivity string

The activity performed. The valid activities are:

  • view
  • share

The socialActivity li is returned if the activityType is social.

webformId string The unique ID for a webform.
webformAction string

The activity performed on the webform. Valid values are:

  • submitted
  • view

The webformAction li is returned if the activityType is webform.

webformName string The name of the webform used. The webformNameli is returned if the activityType is webform.