What is being added?

We are adding the delete permission as part of the Permission sets feature to the DELETE /leads/{id} endpoint.

We will roll the permission out to all companies between June 26 and July 20, 2023.

By default, nothing will be changed in the API behavior.

Users can now be restricted from deleting existing leads, similarly to already existing delete permissions for activities, deals, organizations, persons, and products.

If the user does not have the can_delete_leads permission, calling the DELETE /leads/{id} endpoint will result in a 403 error.

Where can I find the permissions for a user?

The can_delete_leads permission field will be added to the response of the GET /users/{id}/permissions endpoint, which can be used to find a specific user’s permissions.

If you have any questions or comments, let us know in our Developers' Community.