Skip to main content
POST
/
documents
/
library
curl -X POST https://api.hindsight.com/api/v1/documents/library \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "Competitor X Pricing Guide.pdf",
    "file_url": "https://example.com/document.pdf",
    "content_type": "application/pdf",
    "type": "asset",
    "competitor_name": "Competitor X",
    "source": "drive"
  }'

{
  "document": {
    "id": "doc_abc123",
    "file_name": "Competitor X Pricing Guide.pdf",
    "status": "processing",
    "deal_id": "<string>",
    "url": "https://app.hindsight.com/library/doc_abc123",
    "created_at": "2026-02-10T12:00:00Z"
  },
  "workflow_id": "run_xyz789"
}
Upload competitive intelligence documents, assets, and battlecards to your library.

​
Document Types

TypeDescription
assetSales enablement content like battlecards, one-pagers, guides
intelCompetitive intelligence gathered from external sources

​
Source Options

The source field determines the icon displayed in the Hindsight UI:
SourceDescription
driveGoogle Drive
notionNotion
confluenceConfluence
onedriveOneDrive
sharepointSharePoint
vantaVanta
urlWeb URL
zapierZapier automation
apiAPI upload
curl -X POST https://api.hindsight.com/api/v1/documents/library \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "Competitor X Pricing Guide.pdf",
    "file_url": "https://example.com/document.pdf",
    "content_type": "application/pdf",
    "type": "asset",
    "competitor_name": "Competitor X",
    "source": "drive"
  }'

Authorizations

​
Authorization
string
header
required

API key from Hindsight dashboard

Body

application/json
​
file_name
string
required

Name of the file

Example:

"Competitor X Pricing Guide.pdf"

​
content_type
enum<string>
required

MIME type of the file

Available options:
application/pdf,
text/markdown,
text/plain,
application/vnd.openxmlformats-officedocument.wordprocessingml.document,
application/vnd.openxmlformats-officedocument.presentationml.presentation,
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Example:

"application/pdf"

​
type
enum<string>
required

Document type

Available options:
asset,
intel
​
file_url
string<uri>

URL to download the file from (provide either file_url or file_base64)

Example:

"https://example.com/document.pdf"

​
file_base64
string<byte>

Base64-encoded file content (provide either file_url or file_base64)

​
competitor_id
string

Hindsight competitor ID (provide either competitor_id or competitor_name)

Example:

"comp_123"

​
competitor_name
string

Competitor name - will be resolved to competitor_id automatically

Example:

"Competitor X"

​
source
enum<string>

Source application where the document originated

Available options:
drive,
notion,
confluence,
onedrive,
sharepoint,
vanta,
url,
zapier,
api
Example:

"drive"

​
folder_id
string

Folder ID to organize the document

Example:

"folder_123"

Response

Document upload initiated

​
document
object
​
workflow_id
string

ID to track the document processing workflow

Example:

"run_xyz789"