Lead Nurturing API Methods

Get Lead Nurturing Campaign History for a Lead

GET  /nurture/v1/lead/:lead_guid

For a given portal, and a given lead in that portal as specified by its GUID, return a list of lead nurturing campaign history.

Leads are allowed to be in more than one campaign in their lifetimes, and even at the same time. This endpoint will return all of the data for a lead's nurturing history.

Required Parameters How to use Description
Lead GUID Used in the request URL Unique identifier for a particular lead you're looking for.
HubSpot OAuth Access Token access_token=X - Used in the request URL The HubSpot API key for the portal that you're making the call for.
Optional Parameters How to use Description
None None No optional parameters for this method.

Example URL using JSON:  https://api.hubapi.com/nurture/v1/lead/8a706adf32969c770132969c9569000f?access_token=demooooo-oooo-oooo-oooo-oooooooooooo

Example JSON output:

        [
            {
                "leadGuid": "8a706adf32969c770132969c9569000f",
                "campaignGuid": "dd9ba8fa-f7b9-4ece-88d6-cd9dc4124872",
                "status": "Active"
            }
        ]