Account activity timeline
GET
/v1/account/timeline
days, default 30, max 90; limit events, default 60, max 200): verification jobs with their outcome AND why they started (trigger — manual / autofloss / instafloss / decay_protection / api / cron / staff / system — recorded at job start for jobs created after September 2026, inferred from the job's flags before that: see trigger_explicit), settings and connection changes with exact before/after where recorded, and account-state events (support-chat sessions, escalations, ESP connects/disconnects, plan / add-on / auto-refill changes, logins, holds). Built to answer "was this job manual or scheduled?" and "why did my HubSpot run process this many emails?" without guessing. Scoped to the key's account. Ids and internal admin paths only — never emails, IP addresses, user agents, staff identities, tokens or payment data; settings values under credential-looking keys read "redacted". Requires read:jobs.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.mailfloss.com/v1/account/timeline?days=&limit=' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success
{
"generated_at": "2026-09-03T12:00:00.000Z",
"window": {
"since": "2026-08-04T12:00:00.000Z",
"until": "2026-09-03T12:00:00.000Z",
"days": 30
},
"summary": {
"jobs": 2,
"jobs_by_trigger": {
"decay_protection": 1,
"manual": 1
},
"settings_changes": 1,
"account_events": 1,
"truncated": false
},
"events": [
{
"type": "job",
"at": "2026-09-02T03:00:12.000Z",
"job": {
"id": "job_a1b2c3d4e5f6g7h8",
"status": "completed",
"source": "integration",
"source_integration": "hubspot",
"started_at": "2026-09-02T03:00:12.000Z",
"finished_at": "2026-09-02T05:41:30.000Z",
"results": {
"total": 116911,
"passed": 100499,
"failed": 16412
}
},
"trigger": "decay_protection",
"trigger_explicit": true,
"source_action": "cron.decay_protect_hubspot",
"actor": "cron",
"admin_path": "/job/job_a1b2c3d4e5f6g7h8"
},
{
"type": "settings_changed",
"at": "2026-09-01T14:22:05.000Z",
"connection": {
"id": "conn_3f9a2b7c1d",
"type": "hubspot"
},
"actor": "customer",
"source": "updateFlossSettings",
"changes": {
"decayProtectHubSpot": {
"from": false,
"to": true
}
},
"changes_explicit": true,
"fields": [
"decayProtectHubSpot"
],
"admin_path": "/floss-setting/conn_3f9a2b7c1d"
},
{
"type": "account_event",
"at": "2026-09-01T14:20:00.000Z",
"kind": "support_session_opened",
"actor": "customer",
"source": "support_session_mint",
"before": null,
"after": null,
"meta": {}
}
]
}Modified at 2026-10-20 13:54:45