PDF Export in Pipedream
Overview
PDF Export lets you convert HTML content or web pages to PDF directly within your Pipedream workflows. Connect your PDFCrowd account and automate PDF generation with code or no-code steps.
Perfect for: Generating invoices, reports, receipts, contracts, and any document that needs to be created automatically from HTML templates or web page content.
Key Features
- URL to PDF: Convert any publicly accessible web page to PDF
- HTML to PDF: Convert raw HTML content from previous workflow steps
- Seamless integration: Connect with 3,000+ apps available on Pipedream
- Full customization: Control page size, margins, headers, footers, and more
- File output: Get PDF data to use in subsequent workflow steps
How It Works
- Add the PDFCrowd action to your Pipedream workflow
- Connect your PDFCrowd account
- Provide a URL or HTML content to convert
- Configure PDF options (optional)
- Use the generated PDF in subsequent actions
Quick Start
The following examples show how to configure PDF Export actions in your Pipedream workflows.
Note: You need a PDFCrowd account with API access.
For testing, you can use username demo and API key demo.
Sign up to get your own API credentials.
Example 1: Convert a URL to PDF
The simplest use case - convert a web page URL to PDF. This works for any publicly accessible URL.
Workflow Configuration
| Action: | Convert HTML to PDF |
| URL: | https://example.com/invoice/123 |
| Output Filename: | invoice.pdf |
The action outputs PDF data that you can use in subsequent steps - for example, to attach to an email, upload to cloud storage, or send via webhook.
Example 2: Convert HTML Content to PDF
Convert HTML content directly - useful when generating PDFs from templates or data from previous workflow steps.
Workflow Configuration
| Action: | Convert HTML to PDF |
| HTML Content: |
<html>
<body>
<h1>Invoice #${steps.trigger.event.invoice_number}</h1>
<p>Amount: $${steps.trigger.event.amount}</p>
<p>Date: ${steps.trigger.event.date}</p>
</body>
</html>
|
| Output Filename: | invoice-${steps.trigger.event.invoice_number}.pdf |
Use Pipedream's data references to insert dynamic values from trigger data or previous step outputs into your HTML template.
Example 3: Customized PDF Output
Configure PDF options for professional output with custom page size, margins, and headers/footers.
Workflow Configuration
| Action: | Convert HTML to PDF |
| URL: | https://example.com/report |
| Page Size: | Letter |
| Orientation: | landscape |
| Margin Top: | 1in |
| Margin Bottom: | 1in |
| Footer HTML: |
<div style="text-align: center; font-size: 10px;"> Page <span class="pdfcrowd-page-number"></span> of <span class="pdfcrowd-page-count"></span> </div> |
Access all available conversion options including headers, footers, watermarks, and advanced page setup.
Example 4: Complete Workflow
A typical workflow that generates a PDF and sends it via email:
Workflow Steps
- Trigger: HTTP webhook receives form submission
-
Action: PDFCrowd - Convert HTML to PDF
- HTML Content: Custom HTML template with form data
- Output Filename:
submission-${steps.trigger.event.id}.pdf
-
Action: Gmail - Send Email
- Attachment: PDF from step 2
The PDF output from PDFCrowd can be used directly as an attachment in email actions, uploaded to cloud storage, or processed by other apps.
Authentication
When you add the PDFCrowd action to your workflow, Pipedream will prompt you to connect your PDFCrowd account.
Required Credentials
- username
- Your PDFCrowd account username.
- api_key
- Your PDFCrowd API key (not your account password). To get an API key, sign up for a license.
Connecting Your Account
- Add "PDFCrowd" action to your workflow
- Click "Connect Account" when prompted
- Enter your username and API key
- Click "Save" to store the connection
Once connected, Pipedream securely stores your credentials. You can manage your connections in Pipedream's Connected Accounts settings.
Error Handling
Common Errors
401 Unauthorized- Invalid username or API key. Reconnect your PDFCrowd account in Pipedream.
403 Forbidden- Account suspended or insufficient credits. Check your PDFCrowd account.
400 Bad Request- Invalid field values. Ensure you provide either a URL or HTML Content.
430 Too Many Concurrent Requests- Concurrent request limit reached. Configure retry logic in your workflow or add a delay between requests.
See status codes reference for details.
Debugging
- Check your workflow's execution logs for error details
- Verify step references and data mappings are correct
- Test URLs in the API Playground first
- Reconnect your PDFCrowd account if authentication fails
Troubleshooting
Connection Issues
- Use your API key, not your account password
- Reconnect your account if you have changed your API key
- Check Pipedream's Connected Accounts to manage stored credentials
Conversion Issues
Output differs from expected
- Missing styles: Adjust Content Viewport Width
- Dynamic content not rendered: Use Wait For Element or Javascript Delay
- Authentication required: Set Cookies for session data
Missing images
- Use absolute URLs for images
- Ensure images are publicly accessible
- For lazy-loaded images, set Content Viewport Height
Support
- PDFCrowd Support - API questions
- API Playground - Test conversions
- Pipedream Documentation - Workflow questions
Pipedream Reference
Refer for details to the Pipedream Reference.