Quickstart

Prerequisites

Before you begin, you’ll need:

A Fileloom account — Sign up free
An API key from your dashboard

Step 1: Get Your API Key

Go to app.fileloom.io and sign in with Email, Google, or GitHub.

Navigate to API Keys

Click API Keys in the sidebar.

Create New Key

Click Create API Key, give it a name, and copy the key immediately — it won’t be shown again.

Store your API key securely. It provides full access to your workspace and cannot be retrieved after creation.

Step 2: Generate Your First PDF

curl -X POST https://api.fileloom.io/v1/pdf/generate \
  -H "X-API-Key: fl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "htmlContent": "<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>"
  }'

const response = await fetch('https://api.fileloom.io/v1/pdf/generate', {
  method: 'POST',
  headers: {
    'X-API-Key': 'fl_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    htmlContent: '<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>'
  })
});

const result = await response.json();
console.log(result.data.url); // URL to your PDF

import requests

response = requests.post(
    'https://api.fileloom.io/v1/pdf/generate',
    headers={
        'X-API-Key': 'fl_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'htmlContent': '<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>'
    }
)

result = response.json()
print(result['data']['url'])  # URL to your PDF

interface FileloomResponse {
  success: boolean;
  data: {
    fileId: string;
    url: string;
    filename: string;
    size: number;
    processingTimeMs: number;
  };
}

const response = await fetch('https://api.fileloom.io/v1/pdf/generate', {
  method: 'POST',
  headers: {
    'X-API-Key': 'fl_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    htmlContent: '<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>'
  })
});

const result: FileloomResponse = await response.json();
console.log(result.data.url);

$ch = curl_init('https://api.fileloom.io/v1/pdf/generate');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: fl_your_api_key',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'htmlContent' => '<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>'
    ])
]);

$response = curl_exec($ch);
$result = json_decode($response, true);

echo $result['data']['url']; // URL to your PDF

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    payload := map[string]string{
        "htmlContent": "<html><body><h1>My First PDF</h1><p>Generated with Fileloom!</p></body></html>",
    }
    body, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", "https://api.fileloom.io/v1/pdf/generate", bytes.NewBuffer(body))
    req.Header.Set("X-API-Key", "fl_your_api_key")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    
    data := result["data"].(map[string]interface{})
    fmt.Println(data["url"])
}

Step 3: View Your PDF

The response includes a url field with a direct link to your generated PDF:

Response

{
  "success": true,
  "requestId": "req_1734012345_abc123",
  "data": {
    "fileId": "file_1734012345_xyz789",
    "url": "https://storage.googleapis.com/fileloom-prod/workspaces/ws_.../document.pdf",
    "signedUrl": "https://storage.googleapis.com/fileloom-prod/...",
    "filename": "document.pdf",
    "size": 8234,
    "processingTimeMs": 623,
    "generationMethod": "html"
  },
  "usage": {
    "remaining": 1999,
    "quotaUsed": 1,
    "quotaLimit": 2000
  }
}

url — Permanent public URL (valid until retention period expires)
signedUrl — Temporary secure URL (valid for 24 hours)

Step 4: Add Dynamic Data

Use Handlebars syntax to inject dynamic content:

curl -X POST https://api.fileloom.io/v1/pdf/generate \
  -H "X-API-Key: fl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "htmlContent": "<h1>Invoice #{{invoiceNumber}}</h1><p>Amount: {{currency amount \"USD\"}}</p><p>Due: {{formatDate dueDate \"MMMM D, YYYY\"}}</p>",
    "templateData": {
      "invoiceNumber": "INV-2024-001",
      "amount": 299.99,
      "dueDate": "2024-12-31"
    }
  }'

const response = await fetch('https://api.fileloom.io/v1/pdf/generate', {
  method: 'POST',
  headers: {
    'X-API-Key': 'fl_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    htmlContent: '<h1>Invoice #{{invoiceNumber}}</h1><p>Amount: {{currency amount "USD"}}</p><p>Due: {{formatDate dueDate "MMMM D, YYYY"}}</p>',
    templateData: {
      invoiceNumber: 'INV-2024-001',
      amount: 299.99,
      dueDate: '2024-12-31'
    }
  })
});

const result = await response.json();
console.log(result.data.url);

import requests

response = requests.post(
    'https://api.fileloom.io/v1/pdf/generate',
    headers={
        'X-API-Key': 'fl_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'htmlContent': '<h1>Invoice #{{invoiceNumber}}</h1><p>Amount: {{currency amount "USD"}}</p><p>Due: {{formatDate dueDate "MMMM D, YYYY"}}</p>',
        'templateData': {
            'invoiceNumber': 'INV-2024-001',
            'amount': 299.99,
            'dueDate': '2024-12-31'
        }
    }
)

result = response.json()
print(result['data']['url'])

This generates a PDF with:

Invoice #INV-2024-001
Amount: $299.99
Due: December 31, 2024

Step 5: Create a Reusable Template

For repeated use, create a template in the dashboard:

Open Template Editor

Go to Templates → Create Template in the dashboard.

Design Your Template

Write HTML in the editor, add CSS styling, and use {{variables}} for dynamic content.

Test with Sample Data

Enter test JSON in the Test Data tab and preview your PDF in real-time.

Publish

Click Publish to make the template available via API.

Use via API

Reference your template by ID instead of sending raw HTML:

curl -X POST https://api.fileloom.io/v1/pdf/generate \
  -H "X-API-Key: fl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_your_template_id",
    "templateData": {
      "invoiceNumber": "INV-2024-002",
      "amount": 599.99,
      "dueDate": "2025-01-15"
    }
  }'

const response = await fetch('https://api.fileloom.io/v1/pdf/generate', {
  method: 'POST',
  headers: {
    'X-API-Key': 'fl_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    templateId: 'tpl_your_template_id',
    templateData: {
      invoiceNumber: 'INV-2024-002',
      amount: 599.99,
      dueDate: '2025-01-15'
    }
  })
});

const result = await response.json();
console.log(result.data.url);

import requests

response = requests.post(
    'https://api.fileloom.io/v1/pdf/generate',
    headers={
        'X-API-Key': 'fl_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'templateId': 'tpl_your_template_id',
        'templateData': {
            'invoiceNumber': 'INV-2024-002',
            'amount': 599.99,
            'dueDate': '2025-01-15'
        }
    }
)

result = response.json()
print(result['data']['url'])

What’s Next?

Core Concepts

Learn about workspaces, templates, and credits

Template Helpers

Explore 70+ built-in formatting helpers

API Reference

Full endpoint documentation with all options

Code Examples

Examples in 12 programming languages

Getting Started

Dashboard

Template Editor

API Reference

Templates

Helpers

Integrations

Webhooks

Billing

Code Examples

Resources

Prerequisites

Step 1: Get Your API Key

Step 2: Generate Your First PDF

Step 3: View Your PDF

Step 4: Add Dynamic Data

Step 5: Create a Reusable Template

What’s Next?

Core Concepts

Template Helpers

API Reference

Code Examples

​Prerequisites

​Step 1: Get Your API Key

​Step 2: Generate Your First PDF

​Step 3: View Your PDF

​Step 4: Add Dynamic Data

​Step 5: Create a Reusable Template

​What’s Next?

Core Concepts

Template Helpers

API Reference

Code Examples

Prerequisites

Step 1: Get Your API Key

Step 2: Generate Your First PDF

Step 3: View Your PDF

Step 4: Add Dynamic Data

Step 5: Create a Reusable Template

What’s Next?