Files are documents of any kind (images, spreadsheets, text files, etc.) that are uploaded to Pipedrive, and usually associated with a particular deal, person, organization, product, note or activity. Remote files can only be associated with a particular deal, person or organization. Note that the API currently does not support downloading files although it lets you retrieve a file’s meta-info along with a URL which can be used to download the file by using a standard HTTP GET request.
Returns data about all files.
/v1/files
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
sort
string
The field names and sorting mode separated by a comma (field_name_1 ASC
, field_name_2 DESC
). Only first-level field keys are supported (no nested keys). Supported fields: id
, user_id
, deal_id
, person_id
, org_id
, product_id
, add_time
, update_time
, file_name
, file_type
, file_size
, comment
.
OK
Returns data about a specific file.
/v1/files/{id}
id
integer
required
The ID of the file
OK
Initializes a file download.
/v1/files/{id}/download
id
integer
required
The ID of the file
OK
Lets you upload a file and associate it with a deal, person, organization, activity, product or lead. For more information, see the tutorial for adding a file.
/v1/files
multipart/form-data
file
string
required
A single file, supplied in the multipart/form-data encoding and contained within the given boundaries
Format
binary
deal_id
integer
The ID of the deal to associate file(s) with
person_id
integer
The ID of the person to associate file(s) with
org_id
integer
The ID of the organization to associate file(s) with
product_id
integer
The ID of the product to associate file(s) with
activity_id
integer
The ID of the activity to associate file(s) with
lead_id
string
The ID of the lead to associate file(s) with
Format
uuid
OK
Creates a new empty file in the remote location (googledrive
) that will be linked to the item you supply. For more information, see the tutorial for adding a remote file.
/v1/files/remote
application/x-www-form-urlencoded
file_type
string
required
The file type
Values
gdoc
gslides
gsheet
gform
gdraw
title
string
required
The title of the file
item_type
string
required
The item type
Values
deal
organization
person
item_id
integer
required
The ID of the item to associate the file with
remote_location
string
required
The location type to send the file to. Only googledrive
is supported at the moment.
Values
googledrive
OK
Links an existing remote file (googledrive
) to the item you supply. For more information, see the tutorial for adding a remote file.
/v1/files/remoteLink
application/x-www-form-urlencoded
item_type
string
required
The item type
Values
deal
organization
person
item_id
integer
required
The ID of the item to associate the file with
remote_id
string
required
The remote item ID
remote_location
string
required
The location type to send the file to. Only googledrive
is supported at the moment.
Values
googledrive
OK
Updates the properties of a file.
/v1/files/{id}
id
integer
required
The ID of the file
application/x-www-form-urlencoded
name
string
The visible name of the file
description
string
The description of the file
OK
Marks a file as deleted. After 30 days, the file will be permanently deleted.
/v1/files/{id}
id
integer
required
The ID of the file
OK