Get metrics for your contacts based on their lifecycle stage

[Derek_Gervais]

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

[refine_marketin]

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,

/M

[IsaacTakushi]

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:

Screen Shot 2018-10-31 at 9.59.03 AM.png642x644 39.7 KB

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

• Get contacts in a list
• Get recently added contacts from a list

This approach affords more flexibility for multiple breakdowns.

[AjayL]

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

[arnoldmarunda]

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.

[pc4media]

Awesome. Thanks for making this available, HubSpot.

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