Contacts

Contact activity

Events of one contact, oldest first (order=newest for the latest first): widget events, e-mails received, bounced and unsubscribed, clicks, automation runs, the e-mail confirmation and the creation of the contact. Call it to see what a contact did and received. E-mail opens are not listed.

For e-mail events source_id is the broadcast or the automation that sent the message and source_name is its subject. The URL of a click is given without its query string. response_id is the form submission for get_response.

A page holds up to limit events; while next_cursor is set, pass it as cursor for the next page. occurred_since includes events at that moment. Merge repeated reads by id: occurred_at is given to the second, so it does not order events within one second; the cursor keeps the exact order.

get/v1/sites/{site_id}/contacts/{contact_id}/activity

Request

  • Base URL
    https://api.getsitecontrol.com
  • Auth
    HTTP bearer

Path parameters

site_idinteger required
contact_idinteger required

Contact id from list_contacts

Query parameters

cursorstring

next_cursor of the previous page, sent with the same order; omit for the first

limitinteger

Events per page

order'oldest' | 'newest'

Order of a list. oldest: the oldest item first; newest: the newest item first, for the latest items without paging through the history.

Order of the events: oldest first (default) or newest first

occurred_sincestring date-time

Only events at or after this moment; without an offset, taken as UTC; a plain date means its start

typestring[]

Only events of these types; repeat for several. contactCreate and emailConfirmed are the contact's own, widget* widget events, email* e-mails and their clicks, automationStart and automationEnd the start and the end of automation runs

Response

Successful Response

next_cursorstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.