---
title: "Link a remote file to an item"
method: POST
path: "/files/remoteLink"
tags: ["Files"]
---

# Link a remote file to an item

`POST /files/remoteLink`

Links an existing remote file (`googledrive`) to the item you supply. For more information, see the tutorial for <a href="https://pipedrive.readme.io/docs/adding-a-remote-file" target="_blank" rel="noopener noreferrer">adding a remote file</a>.

## Response `200`

Links an existing remote file (googledrive) to the item you supply - deal, person, organization

- object
  - `success` boolean — If the request was successful or not
  - `data` object — The file data
    - `id` integer — The ID of the file
    - `user_id` integer — The ID of the user to associate the file with
    - `deal_id` integer — The ID of the deal to associate the file with
    - `person_id` integer — The ID of the person to associate the file with
    - `org_id` integer — The ID of the organization to associate the file with
    - `product_id` integer — The ID of the product to associate the file with
    - `activity_id` integer — The ID of the activity to associate the file with
    - `lead_id` string, uuid — The ID of the lead to associate the file with
    - `project_id` integer — The ID of the project to associate the file with
    - `add_time` string — The date and time when the file was added/created. Format: YYYY-MM-DD HH:MM:SS
    - `update_time` string — The last updated date and time of the file. Format: YYYY-MM-DD HH:MM:SS
    - `file_name` string — The original name of the file
    - `file_size` integer — The size of the file
    - `active_flag` boolean — Whether the user is active or not. false = Not activated, true = Activated
    - `inline_flag` boolean — Whether the file was uploaded as inline or not
    - `remote_location` string — The location type to send the file to. Only googledrive is supported at the moment.
    - `remote_id` string — The ID of the remote item
    - `cid` string — The ID of the inline attachment
    - `s3_bucket` string — The location of the cloud storage
    - `mail_message_id` string — The ID of the mail message to associate the file with
    - `mail_template_id` string — The ID of the mail template to associate the file with
    - `deal_name` string — The name of the deal associated with the file
    - `person_name` string — The name of the person associated with the file
    - `org_name` string — The name of the organization associated with the file
    - `product_name` string — The name of the product associated with the file
    - `lead_name` string — The name of the lead associated with the file
    - `project_name` string — The name of the project associated with the file
    - `url` string — The URL of the download file
    - `name` string — The visible name of the file
    - `description` string — The description of the file

---

[API](https://skmtc.net/pipedrive/apis/pipedrive-api-v1.md) · [All operations](https://skmtc.net/pipedrive/apis/pipedrive-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedrive/pipedrive-api-v1/versions/bf863a979545/schema)