Skip to content
HubSpot Developer Changelog

New Endpoint: Get Lifecycle Stage metrics for Contacts

New endpoint: Get Lifecycle Stage metrics 

What’s happening?

Today, we’re releasing a new endpoint that will allow you to pull metrics based on the lifecycle stage of your contacts. These metrics will show you the number of contacts that entered each lifecycle stage over the course of a specified time. The metrics can be further aggregated by any enumerated property, including Original Source (hs_analytics_source). You can find more details in the documentation here.

Why is this important?

This would allow you, for example, to get the metrics for the number of new leads and customers over the last 30 days, and break down those records by their source, allowing users of your integration to see the number of new customers that had a source of Organic Search.

Your integration could also display these metrics based on any enumerated property, including any custom enumerated properties that your integration may create.

When is this happening?

This endpoint is available now. The endpoint requires the contacts scope, so if your integration is already working with contacts you’d be able to start using this endpoint without needing your users to re-authorize your integration.

Questions? Join the discussion here or