HomeSandbox AccountsAPI DocumentationApp StudioWebhooksCommunity
API Documentation

List a contact's activities

get https://{youraccountname}.api-us1.com/api/3/activities

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 required

A 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 Deprecated

Contact-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 the reference_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.
Language
Authorization
Header
URL