Requesting Access to "Became a [Lifecycle Stage]" Metrics via HubSpot's API
Request: We request that an API be made public for the HubSpot Marketing metrics “Became a [lifecycle stage]” (Became a Lead, Became a Marketing Qualified Lead, Became a Sales Qualified Lead, Became a Subscriber, etc.). This is necessary for agencies to report on true lifecycle metrics, and is currently a major restriction for Agency partners using a 3rd party reporting tool, such as Databox.
Here’s an example of how a user currently pulls in lifecycle stage information vs. what they’d ideally be able to do.
Current Process: The only data we can currently pull from the API is "New MQLs," "New SQLs," where the lead was created within the same timeperiod the MQL or SQL was generated. For example, if you're looking at a report for "This Month," the HubSpot Mktg metric "New MQLs" will only display MQLs whose leads were created "This Month." This doesn't happen very often for most HubSpot customers since nurturing is usually necessary to turn a lead into an MQL.
HubSpot’s dashboard reports this data in the same limiting way, not showing the full number of MQLs generated in a given month. Here’s an example:
And here is what we’re able to pull via the API that is available:
Current Ineffective Workaround: What's really valuable is seeing how many leads became MQLs during a time period, regardless of the lead create date. Therefore, "Became an MQL" is the filter we want to use or query we want to run. Since this isn’t accessible, we advise our customers to create a Smart List for each lifecycle stage they want to measure (see image below). This is not an ideal solution due to the extra work it requires, the confusion it causes, and the limitations that it presents. For example, we can not see the original traffic source that the contact comes from or view historical data.
Ideal Solution: In order for our users to access the metrics that matter to them, we would love for the following private endpoints to be made available publicly: https://api.hubspot.com/contacts/search/v1/search/contacts