Public API Overview
The DocsToSheets public API gives you programmatic access to the same core capabilities as the web app: create and configure mailboxes, upload documents for extraction, and read the extracted data as structured rows.
Base URL
Section titled “Base URL”https://app.docstosheets.comAll endpoints live under /api. Requests and responses use JSON with camelCase property names.
Requirements
Section titled “Requirements”- A paid plan. Creating API apps and requesting access tokens both require an active paid (Pro) subscription.
- An API app. Create one in the web app under Settings → Developer. Each app gets a
client_idand aclient_secret(shown once at creation).
Authentication
Section titled “Authentication”The API uses the OAuth 2.0 client credentials grant. Exchange your client_id and client_secret for a short-lived access token at /connect/token, then send it as a Bearer token. See Authentication for details.
Scopes
Section titled “Scopes”| Scope | Grants |
|---|---|
api.read | Read mailboxes, documents, extractions, and rows |
api.write | Create, update, and delete the same resources |
What’s included
Section titled “What’s included”The public API is a curated, stable subset of the application’s endpoints:
- Mailboxes — create, list, update, delete, manage extraction config and authorized senders
- Documents — list, get view URLs, delete
- Uploads — upload documents for extraction
- Manual documents — create form-style entries without a source file
- Extractions — read and correct extracted data
- Rows & splits — read the projected spreadsheet rows
Browse the full API Reference for endpoint details, or follow the Quickstart to make your first calls.
Rate limits
Section titled “Rate limits”There are no formal rate limits yet; fair use applies. Formal limits will be announced before they are enforced.