We are introducing ownership permissions inside the Permission sets feature in our web app and API to allow or disable changing the item’s owner for the main entities (activities, deals, leads, organizations, persons, and products).

We will be rolling the feature out to all companies between April 3 and April 12, 2023.

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

When the permission for changing the owner of an entity is disabled for the user making the API request and the user is not a current owner of the entity, the following errors will be thrown:

For the PUT /activities/{id} endpoint, updating the user_id of an activity will throw a 403 error.

For the PUT /deals/{id} endpoint, updating the user_id of a deal will throw a 403 error.

For the PATCH /leads/{id} endpoint, updating the owner_id of a lead will throw a 403 error.

For the PUT /persons/{id} endpoint, updating the owner_id of a person will throw a 403 error.

For the PUT /products/{id} endpoint, updating the owner_id of a product will throw a 403 error.

For the PUT /organizations/{id} endpoint, updating the owner_id of an organization will throw a 403 error.

Here’s an example 403 error response:

{
    "success": false,
    "error": "You do not have permission to change the owner.",
    "error_info": "Please check developers.pipedrive.com for more information about Pipedrive API.",
    "data": null,
    "additional_data": null
}

Please note that the Deals app and Global permissions admin users and the owners of an entity are always able to transfer the ownership of an entity to other users.

The GET /users/{id}/permissions endpoint can be used to find the user’s permissions.

The specified user has permission to update the owner of the entity if the following field(s) are present in the response:

• activities - the can_modify_owner_for_activities field
• deals - the can_modify_owner_for_deals field
• leads - the can_modify_owner_for_leads field
• organizations - the can_modify_owner_for_organizations field
• persons - the can_modify_owner_for_people field
• products - the can_modify_owner_for_products field

If you have any questions or comments, let us know in the Developer’s Community.