Recipe + prompt
Webhook intake for documents
An event starts OCR and IDP idempotently. No double processing.
- 01 Intake
Document arrives
- 02 Recognition
OCR and layout
- 03 Classification
Type and fields
- 04 Review
Rule or person
- 05 Result
Status and export
Implement as
- Starting point
- An event starts OCR and IDP idempotently. No double processing.
- Automated result
- An event starts OCR and IDP idempotently. No double processing.
- Inputs
-
- Document
- Context
- Outputs
-
- Status
- Fields
Flow
- 01Accept intake
- 02Recognize
- 03Review
- 04Task or export
- 05Set status
- Authentication
- Server-side secret key (po_sk_)
Server-side secret key po_sk_ only in the server environment. Idempotency, backoff, no endless retry.
- MCP profile
- Endpoints
-
POST /webhooks/subscribePOST /job/add/paperoffice_aiocr___generatePOST /documents/idp-agent-runGET /job/get/{job_id}
- Modules
-
- Webhook
- OCR
- Classify
- Workflow
- Permissions
- Scope only for POST /webhooks/subscribe, GET /job/get/{job_id}, GET /analytics/calendar-due-dates. No DELETE, admin, billing, or webhook rights on po_pk_.
- Errors and approval
- 401/403: check key, scope, or origin. 402: budget. 429: wait, do not loop. 202: poll until completed. Timeout: retry once, then stop. Mark partial failures.
- Security
-
- secret only in ENV
- verify HMAC
- retry with backoff
- approval for critical actions
Prompt for Autonomous agent
Read this first, in full:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Task:
An event starts OCR and IDP idempotently. No double processing. Use documented endpoints only.
Frame:
- Base URL: https://api.paperoffice.ai/latest
- Build a server-side agent. Credentials only from the environment. Work idempotently.
Only these endpoints:
- POST /webhooks/subscribe
- GET /job/get/{job_id}
- GET /analytics/calendar-due-dates
Errors: stop on 401/403 and check the key. Show budget on 402. Back off on 429. Retry a network error once. Do not invent endpoints. Do not use real tokens.- webhook-document-intake-sample.pdf
- company: Example Ltd
Expected result
recipe=webhook-document-intake, status=ok
Build or sell this solution with PaperOffice?
Integrator and Reseller can be combined. The next step is the partnership — application and instant decision continue in the PaperOffice app.
Start partnership