Get Started

Start generating PDFs with Posiboo in minutes.

Get Started with Posiboo

Posiboo is a PDF generation API that lets you create beautiful PDFs from templates or any web page. Perfect for invoices, reports, certificates, and more.

Quick Start

1. Sign Up and Get Your API Key

  1. Create an account (10 free credits included)
  2. Navigate to API Keys
  3. Create a new API key
  4. Copy and save your key securely

2. Choose Your Rendering Method

Posiboo offers async (with webhooks) and sync (immediate) rendering:

Async Rendering (Recommended for Production)

Submit the job and receive results via webhook. Best for high-volume systems.

javascript
const response = await fetch("https://api.posiboo.com/v1/render/template", {
method: "POST",
headers: {
  "X-API-Key": "your_api_key",
  "Content-Type": "application/json"
},
body: JSON.stringify({
  templateId: "your_template_id",
  data: {
    title: "Invoice #12345",
    customer: "Acme Corp",
    amount: "$1,250.00"
  },
  webhookUrl: "https://your-domain.com/webhooks/pdf"
})
});


// Returns HTTP 202 - PDF delivered to webhook when ready

Sync Rendering (Simple & Immediate)

Get the PDF instantly in the response. Best for backend services and on-demand generation.

javascript
const response = await fetch("https://api.posiboo.com/v1/render/template/sync", {
method: "POST",
headers: {
  "X-API-Key": "your_api_key",
  "Content-Type": "application/json"
},
body: JSON.stringify({
  templateId: "your_template_id",
  data: {
    title: "Invoice #12345",
    customer: "Acme Corp",
    amount: "$1,250.00"
  }
})
});


const pdfBuffer = await response.arrayBuffer();
// PDF ready immediately - save or send it

See all rendering options and examples →

3. Set Up Webhooks (For Async Rendering)

If using async rendering, configure webhooks to receive PDFs:

  1. Go to Webhooks
  2. Create a new webhook endpoint
  3. Verify webhook signatures for security

When a PDF is ready, you'll receive:

json
{
"eventType": "pdf.rendered",
"timestamp": "2024-10-01T12:34:56Z",
"data": {
  "downloadUrl": "https://<download-link-to-pdf>"
}
}

Important: Always verify webhook signatures using HMAC-SHA256 to ensure requests are from Posiboo.

Learn webhook verification and security →

Use or Create Templates

Start with Public Templates (Fastest)

Browse ready-to-use templates for common use cases:

  1. Navigate to Templates Store
  2. Browse the Public Templates section
  3. Click "Use Template" on any template you like
  4. Customize the HTML/CSS or use as-is
  5. Copy your template ID

Available public templates:

  • Invoices - Professional invoice layouts
  • Certificates - Achievement and completion certificates
  • Reports - Business and analytics reports
  • Receipts - Payment and order receipts
  • Letters - Formal letterheads and documents

Create Custom Templates

For unique requirements, build your own:

  1. Click "Create Template" in Templates Store
  2. Design using HTML/CSS
  3. Use {{variableName}} for dynamic data
  4. Test with sample data
  5. Save and copy your template ID

Example custom template:

html
<!DOCTYPE html>
<html>
<head>
<style>
  body { font-family: Arial, sans-serif; }
  .header { color: #333; font-size: 24px; }
</style>
</head>
<body>
<div class="header">{{title}}</div>
<p>Customer: {{customer}}</p>
<p>Amount: {{amount}}</p>
</body>
</html>

API Responses

Async endpoints (/v1/render/template) return 202 Accepted:

bash
HTTP/1.1 202 Accepted
Content-Type: application/json


{ "message": "Rendering job accepted" }

Sync endpoints (/v1/render/template/sync) return 200 OK with the PDF:

bash
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="document.pdf"


<PDF binary data>

Common Use Cases

  • Invoices & Receipts - Generate branded invoices with customer data
  • Reports - Create PDF reports from dashboards or analytics
  • Certificates - Generate certificates of completion or awards
  • Documentation - Export documentation or user guides
  • Statements - Create bank statements, order summaries, etc.

Rate Limits

  • Development: 10 requests per minute per API key
  • Production: Contact us for higher limits

Credits System

Each PDF render consumes 1 credit. Monitor your usage:

  1. View Usage Metrics
  2. Buy more credits via Billing
  3. Track renders in Render Logs

Next Steps

📄 Render Templates

Async and sync rendering with multi-language examples.

Read the guide →

🔒 Webhook Security

Learn signature verification and webhook best practices.

Read the guide →

🔔 Configure Webhooks

Set up webhook endpoints for async rendering.

Set up webhooks →

🔑 API Keys

Manage your API keys and authentication.

Manage keys →

Need Help?

Get Started | Posiboo | Posiboo