View your contact's recent activity. The activity is generated when a contact is retrieved via /api/3/contacts/[contactID]. This endpoint should be used after retrieving a contact to obtain the latest data. This is useful for searching for contacts that match certain criteria - such as being part of a certain list, or having a specific custom field value.
Contact ID parameter is now requiredA contact ID is required to access this endpoint. This endpoint does not support multiple contact IDs with a single call.
Organization-Related Nodes Have Been DeprecatedContact-Organization relationships are now managed through Account-Contact end points
Response Details
-
subscriberid: The unique ID representing the contact (or subscriber) associated with the activity. -
reference_type: Specifies the type of activity being recorded. The activity types can include, but are not limited to:SubscriberEmail: Activity related to email interactions of a subscriber.DealTask: Refers to tasks related to a deal, such as a task assignment or completion.SubscriberList: Actions related to list subscriptions (e.g., subscribing or unsubscribing).SubscriberSeries: Activities associated with an automation sequence, such as starting or completing a step.Log: General logs related to subscriber actions.Update: Logs an update to a contact, deal, or list.DealActivity: Activities related to a deal, often involving interactions such as emails or tasks.Forward: Forwarding actions related to emails.Reply: Responses to emails or messages.Note: Notes added to a subscriber or deal record.LinkData: Tracks interactions with links, such as clicks in emails.MppLinkData: Link interactions via Apple's Mail Privacy Protection.SmsLog: Tracks SMS messages sent to a contact.SmsReply: Tracks replies to SMS messages.SmsUnsub: Unsubscribe actions via SMS.TrackingLog: Tracks interactions through website or email link tracking.SeriesBlock: A step or block in an automation series.SubscriberLog: Logs general subscriber actions.SubscriberConversion: Tracks a subscriber’s conversion event, such as completing a purchase.FbAudienceContactLog: Tracks actions related to Facebook Custom Audience contact interactions.EcomOrderActivity: Activities related to eCommerce orders, such as tracking purchases or cart interactions.
-
reference_id: A unique ID referencing the specific object or event involved in the activity (e.g., a task, note, or automation step). -
reference_action: Describes the action performed in relation to thereference_type. Some common examples include:"start": Typically refers to the initiation of an automation or series step."complete": Indicates the completion of an automation or series step."subscribe": Refers to a subscription action, such as when a contact subscribes to a list.- Other actions might include
"add","update", or be left as an empty string ("") depending on the context.