topic Re: Get metrics for your contacts based on their lifecycle stage in APIs & Integrations

Get metrics for your contacts based on their lifecycle stage

Derek_Gervais — Thu, 19 Apr 2018 20:28:06 GMT

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.

Please reply to this thread if you have any questions about this new endpoint.

https://developers.hubspot.com/docs/methods/contacts/get-lifecycle-stage-metrics-for-contacts

Re: Get metrics for your contacts based on their lifecycle stage

pc4media — Wed, 25 Apr 2018 12:22:02 GMT

Awesome. Thanks for making this available, HubSpot.

We're leveraging this new API here: https://databox.com/accurate-hubspot-lifecycle-stage-reporting-available-databox

Re: Get metrics for your contacts based on their lifecycle stage

arnoldmarunda — Tue, 30 Oct 2018 15:12:25 GMT

Hi,

I am currently using this endpoint to get monthly contact metrics by a property hs_lead_status

Am I able to add another property hubspot_team_id to be able to get further breakdown of the metrics by Hubspot team or even by Hubspot owner?

Any assistance in providing this information is greatly appreciated.

Re: Get metrics for your contacts based on their lifecycle stage

IsaacTakushi — Wed, 31 Oct 2018 14:02:52 GMT

Hi @arnoldmarunda,

At this time, only one aggregation property is supported per request to this endpoint.

That said, you could create lists using the Became a [lifecycle stage] date properties:

and then use either of these Contact Lists API endpoints to retrieve similar data:

This approach affords more flexibility for multiple breakdowns.

Re: Get metrics for your contacts based on their lifecycle stage

refine_marketin — Sun, 17 Feb 2019 16:36:32 GMT

Thx for this new endpoint. I would love to see something similar for Companies as well.

For B2B businesses the KPI's are often based on company level and not contact level.

Looking forward to see higher adoption for B2B companies as well in 2019.

Cheers,

Re: Get metrics for your contacts based on their lifecycle stage

AjayL — Thu, 03 Sep 2020 00:29:33 GMT

Hi,

I want to get a count of 'Became a sales qualified lead date' contacts in my account. We have already defined this list and it would be great if you can help me know how do I obtain the List ID and then subseqeuntly use that in an API call to get the count for a single day.

Thanks