Skip to main content

List Instance Activity Log

GET 
/api/integrations/17track/instances/:instance/activity

Paginated activity log entries scoped to a single 17TRACK integration instance. Surfaces both (1) rows where the instance itself is the activity subject (connect / settings update / disconnect) and (2) rows where properties.integration_instance_id matches (webhook ingest, backfill, quota threshold).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Powers the "Activity" sub-page of the 17TRACK integration UI.

Supported filters:

  • filter[event_type] — comma-separated activity event names (Spatie event column)
  • filter[causer_id] — comma-separated user IDs
  • filter[search] — substring match on description
  • filter[date_from], filter[date_to] — m/d/Y, applied to created_at

Allowed sorts: created_at, event, id (default: -created_at, -id).

Common event values emitted by the 17TRACK module:

  • connected — Integration connected (causer = user)
  • updated — Settings updated (properties.changed_keys)
  • disconnected — Integration disconnected
  • webhook_processed / webhook_failed — per webhook ingest
  • backfill_started / backfill_completed — historical backfill job
  • quota_exceeded — quota threshold reached (no causer)

Responses:

  • 200 OK — paginated activity rows
  • 401 Unauthorized — missing/invalid bearer token
  • 404 Not Found — instance id does not exist

Request​

Responses​

OK

Response Headers
    Content-Type