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.