Overview
The User Last Activity Report provides the most recent timestamps of key actions (read + write) per user. Administrators use it to:- Identify inactive / dormant accounts
- Drive re‑engagement campaigns (email / push)
- Plan archival or deletion workflows (e.g., GDPR cleanup)
- Validate growth & retention metrics against real interaction
Requires an admin session. These endpoints are for server / internal tooling only—never expose admin credentials to clients.
When To Use
Use this report when you need a lightweight snapshot of user activity recency rather than full behavioral analytics. For richer metrics (MAU/DAU, content engagement) see the broader Analytics APIs in the API Overview.Access & Permissions
- Admin credentials (session cookie) required
- Scoped to your network / application only
- Rate limits apply (avoid high-frequency polling—prefer scheduled exports)
Do not embed admin cookie logic in front-end code. Generate and process reports using a secure backend or internal admin tool.
Export Flow
1
Authenticate Admin Session
Submit credentials to obtain an authenticated admin session (cookie-based). Store cookie securely in memory only.
2
Request Report Export
Call the report endpoint. Large datasets may stream or paginate depending on infrastructure.
3
Download / Stream Data
Parse JSON or save CSV output (depending on Accept header or tool). Validate column presence.
4
Process & Act
Join with internal user tables. Segment inactive cohorts. Trigger re‑engagement or cleanup workflows.
API Contract (High-Level)
| Aspect | Value |
|---|---|
| Method | GET |
| Path | /admin/v1/reports/user-last-activity |
| Auth | Admin session cookie |
| Format | JSON (default) or CSV (if Accept: text/csv) |
| Pagination | Implementation-specific (check nextCursor if present) |
Prefer cursor-based pagination (if available) for large networks instead of increasing page size.
Request
Interpreting Results
| Scenario | Interpretation | Suggested Action |
|---|---|---|
| All fields null | Newly created / never logged in | Onboarding reminder |
| Read present, write null | Lurker / consumer only | Engagement nudge (posting tips) |
| Write recent, login stale | Background activity? Validate session tracking | Verify auth flows |
| No activity ≥ 90 days | Dormant account | Re‑engagement or archival workflow |
Automation Ideas
Re‑Engagement Campaigns
Re‑Engagement Campaigns
Export weekly, filter users with
lastActivityAt older than threshold, send personalized email or push, measure reactivation rate.Dormant Cleanup
Dormant Cleanup
Flag accounts inactive > 180 days for soft archival. After notice period, proceed with deletion respecting compliance rules.
Security Monitoring
Security Monitoring
Detect sudden stop in activity of high‑value users—trigger internal review or outreach.
Troubleshooting
| Issue | Possible Cause | Fix |
|---|---|---|
| 401 / Unauthorized | Missing / expired admin cookie | Re-authenticate and resend request |
| Empty dataset | Filters defaulting to restrictive scope (if any) | Remove params / verify user activity exists |
| Missing columns | Feature disabled / retention policy | Confirm configuration; adapt parsing |
| Slow export | Large dataset without pagination | Use pagination or request CSV streaming |
Always log the raw HTTP status + response headers for diagnostics. Store processed data separately from raw export for reproducibility.
Related
API Overview
All admin & analytics APIs
Webhook Events
Real-time notifications
Pre-Hook Events
Intercept & modify events
If you have questions, contact support at [email protected].