hubspot contact timeline missing engagement events error

TL;DR

A timeline shows only engagements associated to the contact. Missing events usually means the email, call, or meeting was logged against the company or deal but never associated to the contact, or tracking was never enabled. Check the association first, then the tracking configuration.

Error

(No error; the symptom is a contact timeline with no emails, calls, or meetings despite known activity.)

Steps

1. Open the engagement (email, call, meeting) and check its associations. Expected: you see whether the contact is associated.
2. If not associated, add the contact association to the engagement. Expected: the event appears on the timeline immediately.
3. For emails, check that the sales extension or tracking is enabled for the sender. Expected: future emails log automatically.
4. For calls and meetings, check the logging defaults in the integration (who gets associated on log). Expected: the defaults include the contact.
5. For agents logging engagements via API, always pass the contact association in the same call. Expected: no orphan engagements going forward.

When to use

• Contact timelines are missing known engagements.
• An agent logs calls or emails that never appear on timelines.
• After changing logging integrations.

When not to use

• Salesforce task/event history (different platform).
• Engagements missing everywhere (then nothing was logged at all).

Tool compatibility

• HubSpot engagements API v3 and the timeline UI.
• Email tracking extensions and calling integrations.

Variant phrasings

timeline empty but activity happened

Association gap; link the engagement to the contact.

emails not logging to HubSpot

Tracking disabled for the sender.

Why it happens

HubSpot's timeline is association-driven, not contact-implicit. An email to a contact's address does not appear on their timeline unless the engagement record is associated to them.

Edge cases

• BCC'd addresses do not auto-associate; the sender must log explicitly.
• Meeting integrations associate the organizer reliably but attendees inconsistently; verify.
• Deleted contacts keep engagements but the timeline is gone; restore or re-associate.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_-6crd-k2V6klx8bqubLsUg