Introducing Leads API

We have added a brand new Leads resource to our Pipedrive API.

In the sales world, Leads are potential Deals that are stored separately in the Leads Inbox within Pipedrive.

The Leads resource allows you to get, create, update and delete Leads, Lead Labels and get Lead Sources.

In API requests, each Lead needs to be named (using the title field) and be linked to either a Person or an Organization. Linking to either a Person or an Organization is required in order to keep all the information regarding Contacts in one part of Pipedrive, instead of separating it between Contacts and Leads Inbox, as it is crucial information in sales peoples' daily work. This way all the communication between the sales person and the contact can be found in one place (Person or Organization detail view in Pipedrive) through the entire sales cycle.

Leads can contain the same custom fields as the custom fields of a Deal. If the value of a custom field has been set for a Lead, it will appear in the response of the request.

The Leads resource includes the following endpoints:

• GET /leads
• GET /leads/{id}
• GET /leadLabels
• GET /leadLabels/{id}
• GET /leadSources
• POST /leads
• POST /leadLabels
• DELETE /leads/{id}
• DELETE /leadLabels/{id}
• PATCH /leads/{id}
• PATCH /leadLabels/{id}

POST and PATCH requests made to the Leads endpoints must be done using content-type: application/json.

Please note that the OAuth scope is currently not available for the Leads endpoints, but we are working to get it added.

Published on July 23, 2020