HubSpot Timeline API Developer - log activities back to your contacts

By Ralph Vugts on Jun 14, 2019
Narrate this article

The HubSpot timeline is a powerful way to log activities back to your contacts, deals or company records.

It's much more versatile than just updating properties on a contact, as each timeline item logged can contain as much info about the event that took place as possible. This can be great for sales teams as they get full visibility over what happened and when.

Workflow Automation

HubSpot timeline events can also be used to trigger workflow automations in HubSpot helping you to further personalise communications to your customers when things happen.

A good example of this with our HubSpot Xero App. When an invoice is raised, payment is made etc this info is pushed into the contacts timeline. This way a thank you email can be sent after it has been received, sales team can see if a payment on their deal has been made which further streamlines their processes and gives them more visibility over what's happening with the account. 


Combining the timeline API with webhooks from remote systems can be a very powerful combo. A webhook from other CRMs or systems like shopping carts can send data to HubSpot when it occurs. Eg. A shopping cart order is placed, the order details can then be inserted into the customer's timeline and their lifecycle status can be set to customer. All this data can then be used for future follow up communications or simply visibility for sales teams. 

Creating HubSpot Timeline Events

This is where it gets tricky. You're going to need a developer (or us - get in touch!) as there are quite a few components to creating these via the API. Zapier and other automation platforms can't do this easily as only support the standard HubSpot objects out-of-the-box. 

Check out the documentation here however if you're in a codey mood.

Ralph has been developing websites and systems for nearly 20 years. Passionate and curious, he’s an a-typical developer who understands how users interact with the systems he builds. He understands that systems need to be human-friendly. Ralph loves working in an industry that is constantly changing and disrupting itself.

Get in touch, We love to talk