Skip to main content

Baserow

Prerequisites​

  • A PolyDoc account and API key — sign up for free, no credit card required. The free plan includes 150 PDF conversions per month.
  • A Baserow account — sign up for free, or self-host the open-source edition.

Use Case 1: Auto-Generate PDFs on New Rows​

Fire a webhook every time a row is created in Baserow, route it through an automation platform, and call PolyDoc to generate a PDF.
Baserow webhook (row created) -> Automation tool -> PolyDoc API -> Email/Storage

Set up your table​

Open your Baserow database and set up a table with the fields your PDF template expects (e.g. customer_name, invoice_number, total). Add a sample row for testing.

Screenshot placeholder: /img/guides/baserow/baserow-uc1-table-setup.png

Configure a webhook on row creation​

Go to your database settings and open Webhooks. Create a new webhook with the event type Row created. Paste the target URL from your automation tool (e.g. a Make or n8n webhook endpoint).

Screenshot placeholder: /img/guides/baserow/baserow-uc1-configure-webhook.png

Connect to an automation tool​

In your automation platform, create a new scenario/workflow triggered by the webhook. Add a step to parse the incoming Baserow payload and extract the row fields.

Screenshot placeholder: /img/guides/baserow/baserow-uc1-automation-tool.png

Add the PolyDoc API step​

Add an HTTP request step that calls PolyDoc:

  • URL: https://api.polydoc.tech/pdf/convert
  • Method: POST
  • Headers:
    • Authorization: Bearer YOUR_API_KEY (get from the Dashboard)
    • Content-Type: application/json
    • X-Sandbox: true
  • Body: JSON mapping the Baserow row fields to your PolyDoc template
Screenshot placeholder: /img/guides/baserow/baserow-uc1-polydoc-step.png

Deliver the PDF​

Add an output step (email, cloud storage, or Slack) to deliver the PDF. Create a test row in Baserow and verify the full chain fires correctly.

Screenshot placeholder: /img/guides/baserow/baserow-uc1-deliver-pdf.png

Use Case 2: Generate PDFs via the Baserow API​

Use Baserow's REST API to fetch row data from a script, then call PolyDoc to generate a PDF — no automation platform needed.
Script -> Baserow API (fetch row) -> PolyDoc API -> PDF

Get your Baserow API token​

In Baserow, go to Settings → API tokens and generate a new token. Grant it read access to the tables you need. Copy the token.

Screenshot placeholder: /img/guides/baserow/baserow-uc2-api-token.png

Fetch row data via the REST API​

From your script (Node.js, Python, etc.), fetch a row using the Baserow REST API:

  • GET https://api.baserow.io/api/database/rows/table/TABLE_ID/ROW_ID/
  • Header: Authorization: Token YOUR_BASEROW_TOKEN
Screenshot placeholder: /img/guides/baserow/baserow-uc2-fetch-row.png

Call PolyDoc API with the data​

Call the PolyDoc API with the row data mapped to your template fields. Use the same endpoint, headers, and body structure described in Use Case 1.

Screenshot placeholder: /img/guides/baserow/baserow-uc2-polydoc-call.png

Save or send the PDF​

The API response contains the binary PDF data. Save it to disk, upload it to cloud storage, or attach it to an email — depending on your use case.

Screenshot placeholder: /img/guides/baserow/baserow-uc2-save-pdf.png