The API is REST with per-document token auth, and the whole flow is roughly 40 lines of code. The complexity lives in choosing which fields are variables and which the rep must edit.

What Can the PandaDoc API Actually Do?

The API covers: create document from template, send document, fetch status, download PDF, and configure webhooks. It does not let you design templates — that stays in the UI.

Endpoints you will use first:

• POST /public/v1/documents — create from template with a tokens payload.
• POST /public/v1/documents/{id}/send — send to a recipient.
• GET /public/v1/documents/{id} — returns status as draft, sent, viewed, completed, or declined.

Auth is an API-Key header, generated under Settings → API. Keys are per workspace, not per user, so rotate them when someone with access leaves.

How Do I Create a Document From Deal Data?

Map CRM fields to template tokens. A token in the template looks like [client.name], and the API call sends it by name.

POST /public/v1/documents
{
  "name": "Proposal - Acme",
  "template_uuid": "YOUR_TEMPLATE_UUID",
  "recipients": [{"email": "buyer@acme.com", "role": "Client", "first_name": "Dana"}],
  "tokens": [
    {"name": "client.name", "value": "Acme Inc"},
    {"name": "deal.amount", "value": "45000"}
  ]
}

Keep the token list short. Every token you add is a field someone has to keep populated in the CRM; unused tokens render as empty space in the sent document.

How Do I Sync Signature Status Back to HubSpot?

Use a webhook, not polling. Register it under Settings → Integrations → API → Webhooks pointing at your endpoint, and subscribe to document.completed.

On receipt, look up the deal by the metadata you attached at creation time — pass your deal ID as metadata so you do not have to match on document name. Then update the deal stage.

Polling the API instead of using webhooks gets rate-limited within a day on an active sales team. There is no reason to do it.

What Are the Rate Limits and Gotchas?

PandaDoc limits API requests to roughly 100 per minute per workspace on standard plans. That is generous for proposal creation and tight if you bulk-generate 500 documents — batch with a delay rather than firing a loop.

Three gotchas worth knowing:

1. A document created with a template must be sent, never edited, or the rep loses the ability to change it in the UI.
2. Tokens with the same name across template versions collide; version your templates and pin the UUID.
3. PDF downloads are metered separately and count against your plan’s document limit on lower tiers. Generating test PDFs repeatedly burns quota.

Is the API Available on the Cheapest Plan?

The API is on every paid plan including Starter at $19 per user per month, but webhooks are effectively a Business feature in practice because the approval workflow they trigger lives there. Check your plan before designing an automation around approvals.

Who Should Not Automate This?

If your reps send fewer than ten proposals a month, the automation costs more to build and maintain than the manual work it replaces. Proposals also carry nuance — a rep editing the summary paragraph often wins the deal. Automate the data, leave the narrative editable.

Quick Summary

• Two API calls create and send a proposal; a webhook syncs status back.
• Pass your CRM deal ID as document metadata so status updates can match reliably.
• Rate limit is about 100 requests per minute per workspace.
• Never edit a document after creating it via the API — send it instead.
• Only worth automating above roughly ten proposals a month.

Most people get value in the first 15 minutes and then stall on templates. That stall is worth understanding before you commit a team to the tool.

What Is PandaDoc and Who Is It For?

PandaDoc is a document automation platform for proposals, quotes, and contracts. Its differentiator is the pricing table with optional line items and approval logic — the buyer can select a tier and the total recalculates inside the document.

It is built for sales teams sending 20+ documents a month. A freelancer sending one proposal a week should compare it against a free Google Doc with a signature add-on before paying per seat.

How Do I Create a Proposal From Scratch?

1. Log in and click New → Document.
2. Choose a template from the library, or start blank and upload a .docx. Import preserves headings and paragraphs but flattens complex layouts — tables and text boxes usually break.
3. Add content blocks on the left rail: text, image, pricing table, video, or a Q&A section.
4. Drag fields from the right rail onto the page: Signature, Initials, Date Signed, Text Field, Dropdown.

Assign a role to each field (Client, Sales Rep). Roles are what let one template serve both parties without duplication.

How Do I Build a Pricing Table That Actually Works?

Pricing tables are where PandaDoc earns or loses the buyer in the first scroll.

• Use the Pricing Table block, not a pasted table. Pasted tables do not compute totals.
• Add optional items only for genuine upsells; more than three options delays decisions.
• Set a currency per document, not per line — mixed currency tables confuse buyers and break discounts.
• Attach an approval workflow if a discount exceeds a threshold; that is a Catalog setting, done under Settings → Approvals.

How Do I Send It and Know If It Was Read?

Click Send. You can require the recipient to view before signing, which builds a stronger audit trail than a plain email attachment.

After sending, the document page shows a timeline: sent, viewed, time spent per page, signed. That view data is the reason sales teams pay for PandaDoc — a proposal read three times on page 4 tells you the pricing table is the sticking point.

Enable reminders on the send dialog. One reminder after 48 hours lifts response rates noticeably, and nobody sends it manually.

How Much Does PandaDoc Cost?

There is a 14-day free trial, no card required, and it limits you to a handful of documents. Paid plans start at $19 per user per month billed annually for the Starter tier, which includes unlimited e-signatures but caps templates.

The Business tier at $49 per user per month is the one most teams actually need, because template locking and approval workflows sit there. Per-seat billing is the trap: a five-person sales team on Business is roughly $2,940 a year, which is more than a small CRM.

Why Do Templates Break on Import?

Word import handles text, headings, and simple lists. It does not handle nested tables, text wrapped around images, multi-column layouts, or embedded footnotes. Those arrive as overlapping boxes you end up rebuilding by hand.

Practical fix: rebuild the layout in PandaDoc natively once, then reuse the digital template. Do not maintain a Word master and re-import it every quarter — that cycle burns an afternoon each time.

Who Should Skip PandaDoc?

Skip it if your proposals never contain pricing options, if one person sends all documents, or if you are already paying for a CRM with native quote generation. PandaDoc’s real value is the pricing table plus the approval chain, and neither matters for a single-sender business.

Quick Summary

• PandaDoc proposals combine editable content, pricing tables and e-signatures in one document.
• Build templates in PandaDoc natively; Word import breaks complex layouts.
• Pricing tables must use the native block or totals will not compute.
• The 14-day trial is card-free; Business tier at $49/user/month unlocks approvals.
• Per-seat pricing is heavy for teams under three users.