API Reference

Activity Feed

Returns recent activity across your account, including deals, subscriptions, and list memberships. Uses the secret key or a personal access token for authentication.

Get Activity Feed

GET /api/v1/activity Secret Key / PAT 30 req/min

Returns up to 50 recent activity items from the last 30 days, merged across enabled modules and sorted by most recent first.

Module Gating

Items are only included for enabled modules:

Deals and list memberships require CRM to be enabled
Subscriptions require Metrics to be enabled

Success Response (200)

{
  "items": [
    {
      "type": "deal",
      "name": "Acme CRM Upgrade",
      "company": "Acme Corp",
      "value_cents": 1500000,
      "stage": "Proposal",
      "created_at": "2026-03-08T12:00:00Z"
    },
    {
      "type": "subscription",
      "company": "Widget Inc",
      "plan_name": "Pro Monthly",
      "status": "active",
      "mrr_cents": 4900,
      "created_at": "2026-03-07T10:00:00Z"
    },
    {
      "type": "list_membership",
      "contact": "jane@example.com",
      "list": "Newsletter",
      "created_at": "2026-03-06T09:00:00Z"
    }
  ]
}

Item Types

Type	Fields
deal	`name`, `company`, `value_cents`, `stage`, `created_at`
subscription	`company`, `plan_name`, `status`, `mrr_cents`, `created_at`
list_membership	`contact`, `list`, `created_at`