⚡ API Export

Your scans, your server

Send scans directly from ScanWow to your own endpoint. No middleman, no monthly integration fee. Just a simple HTTPS POST with your data.

Get the Starter Kit How It Works ↓

How It Works

Three steps. Five minutes. No Zapier subscription required.

1

Deploy the Receiver

Clone our open-source starter kit (Node.js or Python) and deploy to Render, Railway, Vercel, or your own server. One click, free tier friendly.

2

Configure in ScanWow

Open Settings → Integrations → API Export. Paste your endpoint URL and bearer token. Tap "Test Connection" to verify.

3

Scan & Auto-Send

Enable "Auto-send after scan" and every document you scan is automatically sent to your server — including the PDF, extracted text, and metadata.

Quick Start

scanwow-api-receiver
// Clone and deploy in 2 minutes
git clone https://github.com/BrandonS7/scanwow-api-receiver
cd scanwow-api-receiver/node-express

# Set your secret token
export SCANWOW_TOKEN="your-secret-token"

# Install & run
npm install
npm start

# ✅ Listening on port 3000
# POST /api/scans → receives your scans
# Clone and deploy in 2 minutes
git clone https://github.com/BrandonS7/scanwow-api-receiver
cd scanwow-api-receiver/python-flask

# Set your secret token
export SCANWOW_TOKEN="your-secret-token"

# Install & run
pip install -r requirements.txt
python app.py

# ✅ Listening on port 5000
# POST /api/scans → receives your scans
# Test your endpoint with cURL
curl -X POST https://your-server.com/api/scans \
  -H "Authorization: Bearer your-secret-token" \
  -F "metadata={\"scanId\":\"test\",\"title\":\"Test\"};type=application/json" \
  -F "ocrText=Hello from ScanWow!"

# Response: { "status": "received", "scanId": "test" }

Payload Format

Sent as multipart/form-data via HTTPS POST with Bearer token auth.

Field Type Description
metadata JSON Scan ID, title, page count, language, timestamp, app version
ocrText Text Extracted text (Magic Text if enabled, raw OCR otherwise)
pdf File Generated PDF of the scanned document (optional)
image_0, image_1 File Original scan images (optional, configurable)

Why API Export?

Skip the $20/month integration tools. Own your data pipeline.

🔒

Your Data, Your Server

Scans go directly from your iPhone to your endpoint. ScanWow never stores or routes your data through our servers.

Auto-Send

Enable auto-send and every scan is automatically pushed after OCR completes — including Magic Text AI enhancement.

🆓

Free & Open Source

The receiver starter kit is MIT licensed. No API keys, no per-request fees, no vendor lock-in.

🚀

Deploy Anywhere

Render, Railway, Vercel, AWS, your Raspberry Pi — if it speaks HTTPS, it works with ScanWow.

🔑

Bearer Token Auth

Simple, secure authentication. Your token never leaves your device — sent only in the Authorization header over HTTPS.

📦

Flexible Payload

Choose what to send: PDF, extracted text, original images, or all three. Configure per your workflow needs.

Ready to build?

Clone the starter kit, deploy in 5 minutes, and start receiving scans from ScanWow.

View on GitHub Download ScanWow →