---
title: API Call - Upload Documents
description: Detailed specification and usage guide for the Upload Documents API call
---

[Skip to content](https://support.loomanalytics.com/api-call-upload-documents#main-content)

English

Show submenu for translations

![Loom\_Analytics\_Logo\_Transparent.png\]](https://support.loomanalytics.com/hs-fs/hubfs/Loom_Analytics_Logo_Transparent.png?height=40&name=Loom_Analytics_Logo_Transparent.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Loom Analytics

 Loom Analytics

 Let's Get Started. What Can I Help You With?

- There are no suggestions because the search field is empty.

1. [Loom Analytics Knowledge Base](https://support.loomanalytics.com/?hsLang=en)
2. [Loom Analytics Developer Documentation](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en)
3. [API Calls](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#api-calls)

# API Call - Upload Documents

## Detailed specification and usage guide for the Upload Documents API call

This API call is used to send non-media files when text documents in PDF, rich text, or text format are required for text extraction to complete a Loom Analytics workflow. Data from these documents is automatically scraped in the Loom Analytics workflow to be inserted into the generated transcript.

**Description:** Use this call to upload a new document to Loom Analytics. If more than one document needs to be uploaded, you will need to make a separate call for each document.

**Parameters:**

| **Name** | **Description** | **Usage** | **Type** | **Required** |
| --- | --- | --- | --- | --- |
| Key | API Key provided | In Request Body | Text | True |
| Secret | API Secret provided | In Request Body | Text | True |
| File | Document for job | In Request Body (form data) | File | True |

     **![](https://support.loomanalytics.com/hs-fs/hubfs/image-png-Jan-21-2026-08-17-06-4383-PM.png?width=670&height=144&name=image-png-Jan-21-2026-08-17-06-4383-PM.png)

Expected Response:**

```
{    "msg": "SUCCESS: File `Sample_File_1.pdf` uploaded. ",    "file_url": "EncryptedDocumentURL",    "return": "msg,file_url",    "url": "https://link.to.the.file/api/Sample_File_1.pdf"}
```

| **Status** | **Meaning** | **Description** |
| --- | --- | --- |
| 200 | OK | File upload is complete |
| 400 | Bad Request | Unexpected error occurred |
| 401 | Unauthorized | User not authorized |
| 500 | Internal Server Error | Internal Server Error |

 

Next: You are ready to <https://support.loomanalytics.com/api-call-upload-documents>[Submit the Job](https://support.loomanalytics.com/api-call-submit?hsLang=en) to Loom Analytics

 

[**Link to Postman Collection**](https://developer.loomanalytics.com/#f5d79341-f8a4-4854-b0bf-f69be06ba0b8)

- [Loom Analytics Web](https://support.loomanalytics.com/loom-analytics-web?hsLang=en#main-content)

    - [Introduction](https://support.loomanalytics.com/loom-analytics-web?hsLang=en#introduction)
    - [Getting Started](https://support.loomanalytics.com/loom-analytics-web?hsLang=en#getting-started)
    - [Processing Transcripts](https://support.loomanalytics.com/loom-analytics-web?hsLang=en#processing-transcripts)
- [Loom Analytics Desktop](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#main-content)

    - [Getting Started](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#getting-started)
    - [Live Recording](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#live-recording)
    - [Uploading Pre-Recorded Audio](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#uploading-pre-recorded-audio)
    - [Editing Transcripts](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#editing-transcripts)
    - [Managing Recordings & Cases](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#managing-recordings-cases)
    - [Uninstalling Loom Analytics Desktop](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#uninstalling-loom-analytics-desktop)
    - [Troubleshooting](https://support.loomanalytics.com/loom-analytics-desktop?hsLang=en#troubleshooting)
- [Loom Analytics Desktop - Hermit](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#main-content)

    - [User Manual](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#user-manual)
    - [Introduction](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#introduction)
    - [Getting Started](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#getting-started)
    - [Editing Transcripts](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#editing-transcripts)
    - [Loom Analytics Desktop - Hermit - App Expired](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#loom-analytics-desktop-hermit-app-expired)
    - [How to Download & Install Loom Analytics Desktop - Hermit](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#how-to-download-install-loom-analytics-desktop-hermit)
    - [Limitations of Loom Analytics Desktop - Hermit](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#limitations-of-loom-analytics-desktop-hermit)
    - [How Do I Get Loom Analytics Web Profiles on Loom Analytics Desktop - Hermit?](https://support.loomanalytics.com/loom-analytics-desktop-hermit?hsLang=en#how-do-i-get-loom-analytics-web-profiles-on-loom-analytics-desktop-hermit)
- [Loom Analytics: Mobile](https://support.loomanalytics.com/loom-analytics-mobile?hsLang=en#main-content)

    - [Introduction](https://support.loomanalytics.com/loom-analytics-mobile?hsLang=en#introduction)
    - [Loom Analytics Mobile: How It Works](https://support.loomanalytics.com/loom-analytics-mobile?hsLang=en#loom-analytics-mobile-how-it-works)
- [Loom Analytics Web: Processing Jobs](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#main-content)

    - [File Submission](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#file-submission)
    - [Editing Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#editing-transcripts)
    - [File Types & Sizes](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#file-types-sizes)
    - [Ontario ACT Legal Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#ontario-act-legal-transcripts)
    - [General Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#general-transcripts)
    - [Legal Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#legal-transcripts)
    - [Insurance Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#insurance-transcripts)
    - [Medical Transcripts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#medical-transcripts)
    - [Security](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#security)
    - [Usage](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#usage)
    - [Nova Scotia Courts](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#nova-scotia-courts)
    - [Multilingual Transcription & Translation](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#multilingual-transcription-translation)
    - [Translate and Transcribe From Non-English Media](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#translate-and-transcribe-from-non-english-media)
    - [How Can I Delete Job Data for Multiple Jobs?](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#how-can-i-delete-job-data-for-multiple-jobs)
    - [How to Convert a .dcr Media File to .wav, .avi, .wma, or .wmv on Liberty Player](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#how-to-convert-a-dcr-media-file-to-wav-avi-wma-or-wmv-on-liberty-player)
    - [How Can I Export Only a Specific Channel From a Multichannel .dcr File?](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#how-can-i-export-only-a-specific-channel-from-a-multichannel-dcr-file)
    - [How Can I Have Timestamps on Every Speaker Change?](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#how-can-i-have-timestamps-on-every-speaker-change)
    - [TimeSync Playback on Loom Analytics Web](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#timesync-playback-on-loom-analytics-web)
    - [Unified Flow](https://support.loomanalytics.com/loom-analytics-web-processing-jobs?hsLang=en#unified-flow)
- [Loom Analytics Web: Profiles & Workflows](https://support.loomanalytics.com/loom-analytics-web-profiles-workflows?hsLang=en#main-content)

    - [Smart Formatting](https://support.loomanalytics.com/loom-analytics-web-profiles-workflows?hsLang=en#smart-formatting)
    - [Creating & Managing Your Profiles](https://support.loomanalytics.com/loom-analytics-web-profiles-workflows?hsLang=en#creating-managing-your-profiles)
    - [How Can I Create a Template for my Loom Analytics Web Profile?](https://support.loomanalytics.com/loom-analytics-web-profiles-workflows?hsLang=en#how-can-i-create-a-template-for-my-loom-analytics-web-profile)
- [Loom Analytics Web: Mac Users](https://support.loomanalytics.com/loom-analytics-web-mac-users?hsLang=en)
- [MS Word Support](https://support.loomanalytics.com/ms-word-support?hsLang=en#main-content)

    - [MS Word Templates & Macros: Setup](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-templates-macros-setup)
    - [MS Word Templates & Macros: Macros](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-templates-macros-macros)
    - [MS Word Basics: Searching & Viewing](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-basics-searching-viewing)
    - [MS Word Basics: MS Word Hotkeys](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-basics-ms-word-hotkeys)
    - [MS Word Basics: Saving & Proofing](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-basics-saving-proofing)
    - [MS Word Basics: Formatting](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-basics-formatting)
    - [MS Word Basics: General](https://support.loomanalytics.com/ms-word-support?hsLang=en#ms-word-basics-general)
- [A/V Support](https://support.loomanalytics.com/a-v-support?hsLang=en#main-content)

    - [Converting Audio to Text](https://support.loomanalytics.com/a-v-support?hsLang=en#converting-audio-to-text)
    - [Converting Video to Text](https://support.loomanalytics.com/a-v-support?hsLang=en#converting-video-to-text)
    - [Audio Transcription Playback Software: Liberty Player](https://support.loomanalytics.com/a-v-support?hsLang=en#audio-transcription-playback-software-liberty-player)
    - [Audio Transcription Playback Software: FTR (For The Record)](https://support.loomanalytics.com/a-v-support?hsLang=en#audio-transcription-playback-software-ftr-for-the-record)
    - [Audio Transcription Playback Software: VIQ Player](https://support.loomanalytics.com/a-v-support?hsLang=en#audio-transcription-playback-software-viq-player)
    - [Audio Transcription Playback Software: VLC Media Player](https://support.loomanalytics.com/a-v-support?hsLang=en#audio-transcription-playback-software-vlc-media-player)
    - [Audio Transcription Playback Software: Express Scribe](https://support.loomanalytics.com/a-v-support?hsLang=en#audio-transcription-playback-software-express-scribe)
- [Computer Configuration](https://support.loomanalytics.com/computer-configuration?hsLang=en#main-content)

    - [Hardware](https://support.loomanalytics.com/computer-configuration?hsLang=en#hardware)
    - [Software](https://support.loomanalytics.com/computer-configuration?hsLang=en#software)
    - [Windows Settings](https://support.loomanalytics.com/computer-configuration?hsLang=en#windows-settings)
- [Resource Centre](https://support.loomanalytics.com/resource-centre?hsLang=en#main-content)

    - [Team Admin - User Invitation Process](https://support.loomanalytics.com/resource-centre?hsLang=en#team-admin-user-invitation-process)
    - [Loom Analytics: Reports](https://support.loomanalytics.com/resource-centre?hsLang=en#loom-analytics-reports)
- [Illoominate Academy](https://support.loomanalytics.com/illoominate-academy?hsLang=en#main-content)

    - [Illoominate Academy Courses](https://support.loomanalytics.com/illoominate-academy?hsLang=en#illoominate-academy-courses)
- [Loom Analytics Developer Documentation](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#main-content)

    - [Postman](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#postman)
    - [API Account Specific Setup](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#api-account-specific-setup)
    - [API Calls](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#api-calls)
    - [Webhook](https://support.loomanalytics.com/loom-analytics-developer-documentation?hsLang=en#webhook)
- [Loom Analytics Product Updates](https://support.loomanalytics.com/loom-analytics-product-updates?hsLang=en#main-content)

    - [August 2024](https://support.loomanalytics.com/loom-analytics-product-updates?hsLang=en#august-2024)
    - [July 2024](https://support.loomanalytics.com/loom-analytics-product-updates?hsLang=en#july-2024)
    - [March 2024](https://support.loomanalytics.com/loom-analytics-product-updates?hsLang=en#march-2024)
- [FAQ](https://support.loomanalytics.com/faq?hsLang=en)

[![Chill listening crop-3](https://support.loomanalytics.com/hs-fs/hubfs/Loom_Analytics_Logo_Transparent.png?width=100&height=30&name=Loom_Analytics_Logo_Transparent.png "Chill listening crop-3")](https://www.loomanalytics.com)

Loom Analytics Knowledge Base

<https://www.linkedin.com/company/loom-analytics> <https://www.facebook.com/LoomAnalytics>

Copyright © 2026, Loom Analytics