PDFHQ logo

Documents

PDFHQ / Developer API

PDF automation.
One predictable workflow.

Build document processing into your application. Upload securely, run asynchronous tasks and deliver finished files — with one account for access, credits and usage.

Automation integrations
A task. A complete workflow. REST API v1
POST/v1/tasks
{
  "tool": "compress",
  "status": "waiting",
  "progress": 0,
  "output_ready": false
}

Illustrative response · create a compression task

01
Create & upload

Private storage. Direct from your application.

02
Approve & process

A clear quote before work begins.

03
Retrieve & continue

Track progress. Fetch the finished document.

Scoped by design

Project API keys keep access and resources in the right hands.

Files take the direct route

Signed URLs move large documents straight to private storage.

Built for asynchronous work

Stable task IDs, clear status and a documented retry lifecycle.

Automation & integrations

Connect PDFHQ to your workflow.

From a single API request to an automated document pipeline. Choose how your applications, tools and agents work with PDFHQ.

Automation setup guide
No-code workflows

Zapier

Use PDF/AI completion triggers, create processing jobs or quotes, and prepare unsent sandbox signing drafts.

Private integration

A project API key and staged webhook delivery are required for live REST Hook triggers.

View Zapier guide
Agent tooling

MCP for AI agents

Expose permitted PDF and AI operations to an OAuth-connected agent without a second billing system.

Local deployment

The hosted endpoint is a deployment target, not a currently certified public service.

View MCP for AI agents guide
Server-to-server events

Event webhooks

Subscribe to signed PDF, AI and signing status events; inspect deliveries, replay failures and rotate secrets.

Activation required

Requires an enabled event outbox, worker, secret encryption and staging acceptance.

View Event webhooks guide
REST API + SDKs

Custom automation

Compose your own workflows with project API keys, direct uploads, idempotent tasks and polling.

REST API + SDKs

Native Make and n8n integrations are not shipped; use HTTP calls in your own workflow.

View setup

Explore each guide for availability, activation requirements and supported workflows.

The task lifecycle

From request to result. Four clear steps.

Full task lifecycle
01

Create a task

Authenticate with a project API key and choose your PDF operation.

02

Upload directly

Send your files straight to private storage with a signed upload URL.

03

Approve & process

Review the credit quote, approve it and queue your document task.

04

Retrieve results

Follow task progress and download results through a signed URL.

Task API · cURL
# Create a PDF compression task
curl -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

# Next: upload, attach files and approve the quote.
# Follow the quickstart for the complete lifecycle.
A foundation you can build on

Your documents.
Your application. One API.

Keep task creation, uploads, processing and delivery predictable. Build around stable IDs and verify results before they reach your users.

  • PDF conversion and document processing
  • Custom operations and validated options
  • AI document workflows and result exports
  • Signing sandbox and envelope workflows

Supported operations, AI models and signing providers depend on your account and deployment. Explore the guides for details.

Build your next document workflow.

Start with a task. Follow the guide. Make it your own.

Get started with PDFHQ
PDFHQ logo

PDF tools and document intelligence. Prepare, understand and work with your documents.

© 2026 PDFHQ. All rights reserved.