Users are people with access to your Pipedrive account. A user may belong to one or many Pipedrive accounts, so deleting a user from one Pipedrive account will not remove the user from the data store if he/she is connected to multiple accounts. Users should not be confused with persons.
/v1/users
Returns data about all users within the company.
OK
/v1/users/find
Finds users by their name.
term
string
required
The search term to look for
search_by_email
number
When enabled, the term will only be matched against email addresses of users. Default: false
Default
0
Values
0
1
OK
/v1/users/me
Returns data about an authorized user within the company with bound company data: company ID, company name, and domain. Note that the locale
property means 'Date/number format' in the Pipedrive account settings, not the chosen language.
OK
/v1/users/{id}
Returns data about a specific user within the company.
id
integer
required
The ID of the user
OK
/v1/users/{id}/followers
Lists the followers of a specific user.
id
integer
required
The ID of the user
OK
/v1/users/{id}/permissions
Lists aggregated permissions over all assigned permission sets for a user.
id
integer
required
The ID of the user
OK
/v1/users/{id}/roleAssignments
Lists role assignments for a user.
id
integer
required
The ID of the user
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
OK
/v1/users/{id}/roleSettings
Lists the settings of user's assigned role.
id
integer
required
The ID of the user
OK
/v1/users
Adds a new user to the company, returns the ID upon success.
application/x-www-form-urlencoded
name
string
required
The name of the user
string
required
The email of the user
active_flag
boolean
required
Whether the user is active or not. false
= Not activated, true
= Activated
Default
true
OK
/v1/users/{id}/roleAssignments
Adds a role assignment for a user.
id
integer
required
The ID of the user
application/x-www-form-urlencoded
role_id
integer
required
The ID of the role
OK
/v1/users/{id}
Updates the properties of a user. Currently, only active_flag
can be updated.
id
integer
required
The ID of the user
application/x-www-form-urlencoded
active_flag
boolean
required
Whether the user is active or not. false
= Not activated, true
= Activated
Default
true
OK
/v1/users/{id}/roleAssignments
Deletes a role assignment for a user.
id
integer
required
The ID of the user
application/x-www-form-urlencoded
role_id
integer
required
The ID of the role
OK