---
sidebar_position: 3
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Add external file
 Adds a new external file



`Function AddExternalFile(Val Token, Val URL, Val Title) Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Bot token |
  | URL | --url | String | ✔ | URL to external file |
  | Title | --title | String | ✔ | File title for Slack |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Slack

<br/>




```bsl title="1C:Enterprise/OneScript code example"
    Token = "xoxb-6965308400114-696804637...";
    Title = "NewFile";
    File  = "https://api.athenaeum.digital/test_data/document.docx";

    Result = OPI_Slack.AddExternalFile(Token, File, Title);
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint slack AddExternalFile \
             --token "***" \
             --url "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx" \
             --title "NewFile"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint slack AddExternalFile ^
             --token "***" ^
             --url "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx" ^
             --title "NewFile"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "ok": true,
 "file": {
  "id": "F07QYP172FP",
  "created": 1728454531,
  "timestamp": 1728454531,
  "name": "NewFile",
  "title": "NewFile",
  "mimetype": "application/vnd.slack-remote",
  "filetype": "remote",
  "pretty_type": "Remote",
  "user": "U06UG1CAYH2",
  "user_team": "T06UD92BS3C",
  "editable": false,
  "size": 0,
  "mode": "external",
  "is_external": true,
  "external_type": "app",
  "is_public": false,
  "public_url_shared": false,
  "display_as_bot": false,
  "username": "",
  "url_private": "https://slack.com/api/files.remote.add",
  "media_display_type": "unknown",
  "permalink": "https://openintegrationsgroup.slack.com/files/U06UG1CAYH2/F07QYP172FP/newfile",
  "comments_count": 0,
  "is_starred": false,
  "shares": {},
  "channels": [],
  "groups": [],
  "ims": [],
  "has_more_shares": false,
  "external_id": "3a61913c-c2ce-412b-a4b4-6875373db31a",
  "external_url": "https://slack.com/api/files.remote.add",
  "has_rich_preview": false,
  "file_access": "visible"
 }
}
```