Users
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.
Get all users
/v1/users
Returns data about all users within the company.
Response
OK
Expand all
Copy code- true
- [ ... ]▶
Find users by name
/v1/users/find
Finds users by their name.
Query parameters
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
Response
OK
Expand allCopy code- true
- [ ... ]▶
Get current user data
/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.
Response
OK
Expand allCopy code- true
- { ... }▶
Get one user
/v1/users/{id}
Returns data about a specific user within the company.
Path parameters
id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- { ... }▶
List followers of a user
/v1/users/{id}/followers
Lists the followers of a specific user.
Path parameters
id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- [ ... ]▶
List user permissions
/v1/users/{id}/permissions
Lists aggregated permissions over all assigned permission sets for a user.
Path parameters
id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- { ... }▶
List role assignments
/v1/users/{id}/roleAssignments
Lists role assignments for a user.
Path parameters
id
integer
required
The ID of the user
Query parameters
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
Response
OK
Expand allCopy code- true
- [ ... ]▶
- { ... }▶
List user role settings
/v1/users/{id}/roleSettings
Lists the settings of user's assigned role.
Path parameters
id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- { ... }▶
Add a new user
/v1/users
Adds a new user to the company, returns the ID upon success.
Body parameters
application/json
string
required
The email of the user
name
string
The name of the user
access
array
The access given to the user. Each item in the array represents access to a specific app. Optionally may include either admin flag or permission set ID to specify which access to give within the app. If both are omitted, the default access for the corresponding app will be used. It requires structure as follows: [{ app: 'sales', permission_set_id: '62cc4d7f-4038-4352-abf3-a8c1c822b631' }, { app: 'global', admin: true }, { app: 'account_settings' }]
Default
[{ app: 'sales' }]
active_flag
boolean
Whether the user is active or not. false = Not activated, true = Activated
Default
true
Response
OK
Expand allCopy code- true
- { ... }▶
Update user details
/v1/users/{id}
Updates the properties of a user. Currently, only active_flag can be updated.
Path parameters
id
integer
required
The ID of the user
Body parameters
application/json
active_flag
boolean
required
Whether the user is active or not. false = Not activated, true = Activated
Response
OK
Expand allCopy code- true
- { ... }▶