POST /files.upload

Uploads or creates a file.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

Request body fields

Name Type Required Description
channels String No

Comma-separated list of channel names or IDs where the file will be shared.

initial_comment String No

The message text introducing the file in specified channels.

filename String No

Filename of file.

token String No

Authentication token. Requires scope: files:write:user

content String No

File contents via a POST variable. If omitting this parameter, you must provide a file.

title String No

Title of file.

thread_ts Number No

Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.

filetype String No

A file type identifier.

file String No

File contents via multipart/form-data. If omitting this parameter, you must submit content.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.