Records in, PDFs back — inside Airtable.

Prerequisites

• An ASHDOCS account — the free tier includes 100 monthly credits, no card required.
• An API key from the dashboard (Keys page). Sandbox keys (prefix ash_test_) run everything without consuming credits.
• An Airtable base with automations available — script steps and run volumes vary by Airtable plan, so check your plan's automation limits.

Test the key before building anything:

curl https://www.ashdocs.com/api/v1/me -H "X-API-Key: ash_live_..."

Setup, step by step

1. 1

   Create the automation

   Automations → New automation. Trigger: “When record matches conditions” (for example Status is “Approved”).

2. 2

   Add a script action

   Add action → “Run a script”. In the left panel add input variables from the triggering record: recordId, invoiceNo, client, amount.

3. 3

   Paste the script

   The script calls the API with output set to “url”, then writes the returned link into an attachment field — Airtable ingests attachments from URLs automatically.

   const { recordId, invoiceNo, client, amount } = input.config();
   
   const res = await fetch("https://www.ashdocs.com/api/v1/tools/html-to-pdf", {
     method: "POST",
     headers: { "X-API-Key": "ash_live_...", "Content-Type": "application/json" },
     body: JSON.stringify({
       html: `<h1>Invoice ${invoiceNo}</h1><p>${client} — $${amount}</p>`,
       options: { format: "A4", output: "url" }
     })
   });
   if (!res.ok) throw new Error(await res.text());
   const { file_url } = await res.json();
   
   const table = base.getTable("Invoices");
   await table.updateRecordAsync(recordId, {
     "PDF": [{ url: file_url, filename: `invoice-${invoiceNo}.pdf` }]
   });

4. 4

   Test and turn on

   Run a test with a real record — the PDF appears in the attachment field within seconds. Turn the automation on.

Three ready-made recipes

Troubleshooting

Frequently asked questions