> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pdfnoodle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Make Integration

> Automate PDF generation workflows by connecting Make with pdf noodle

Integrate pdf noodle with [Make](https://make.com) (formerly Integromat) to automate your PDF generation workflows. Connect to 1000+ apps and generate documents automatically.

## Prerequisites

Before you begin, make sure you have:

* A pdf noodle account ([sign up here](https://app.pdfnoodle.com/auth/sign-up))
* Your API key from [API Settings](https://app.pdfnoodle.com/settings/api)
* At least one template created in pdf noodle
* A Make account ([sign up here](https://make.com))

***

## Setting Up the Integration

Make connects to pdf noodle using the **HTTP module** to call the API directly.

<Steps>
  <Step title="Create a New Scenario">
    In Make, click **Create a new scenario** and add your trigger (e.g., Google Sheets, Webhook, or any other app).
  </Step>

  <Step title="Add HTTP Module">
    Click the **+** button and search for **HTTP**. Select **Make a request**.
  </Step>

  <Step title="Configure the Request">
    Set up the HTTP module with these settings:

    | Setting          | Value                                   |
    | ---------------- | --------------------------------------- |
    | **URL**          | `https://api.pdfnoodle.com/v1/pdf/sync` |
    | **Method**       | `POST`                                  |
    | **Headers**      | See below                               |
    | **Body type**    | `Raw`                                   |
    | **Content type** | `JSON (application/json)`               |

    **Headers:**

    | Name            | Value                 |
    | --------------- | --------------------- |
    | `Authorization` | `Bearer YOUR_API_KEY` |
    | `Content-Type`  | `application/json`    |
  </Step>

  <Step title="Set the Request Body">
    Add the JSON body with your template ID and data:

    ```json theme={null}
    {
      "templateId": "your-template-id",
      "data": {
        "customerName": "{{1.customer_name}}",
        "invoiceNumber": "{{1.invoice_id}}",
        "items": {{1.items}},
        "total": {{1.total}}
      }
    }
    ```

    Use Make's variable picker to map fields from your trigger.
  </Step>

  <Step title="Parse the Response">
    The response contains the PDF URL:

    ```json theme={null}
    {
      "signedUrl": "https://pdforge-production.s3.us-east-2.amazonaws.com/...",
      "metadata": {
        "executionTime": "1.805 seconds",
        "fileSize": "4.066 kB"
      }
    }
    ```

    Check **Parse response** to use the `signedUrl` in subsequent modules.
  </Step>
</Steps>

***

## Finding Your Template ID

1. Go to [app.pdfnoodle.com](https://app.pdfnoodle.com)
2. Navigate to the **Templates** section
3. Copy the Template ID shown in the list next to your template

***

## Example: Invoice on New Order

A typical scenario that generates an invoice when a new order is received:

1. **Trigger** - Shopify "Watch Orders" or Webhook
2. **HTTP Module** - Generate PDF with pdf noodle
3. **Email Module** - Send the PDF to the customer

***

## Using the PDF URL

After generating the PDF, you can use the URL to:

* **Send via Email** - Attach or link in Gmail, Outlook, etc.
* **Upload to Storage** - Save to Google Drive, Dropbox, S3
* **Update Records** - Add the link to Airtable, Notion, CRM
* **Send via Chat** - Share in Slack, Teams, Discord

***

## Error Handling

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    * Verify your API key is correct
    * Ensure the Authorization header format is `Bearer YOUR_API_KEY`
  </Accordion>

  <Accordion title="400 Bad Request">
    * Check your JSON syntax is valid
    * Ensure all required template variables are provided
    * Verify the template ID exists
  </Accordion>

  <Accordion title="Timeout Errors">
    * Increase the HTTP module timeout in advanced settings
    * Use the async endpoint for large PDFs: `https://api.pdfnoodle.com/v1/pdf/async`
  </Accordion>
</AccordionGroup>

***

## API Endpoints

| Endpoint                    | Description                               |
| --------------------------- | ----------------------------------------- |
| `POST /v1/pdf/sync`         | Generate PDF from template (synchronous)  |
| `POST /v1/pdf/async`        | Generate PDF from template (asynchronous) |
| `POST /v1/html-to-pdf/sync` | Convert HTML to PDF (synchronous)         |

<Info>
  See the complete [API Reference](/api-reference) for all endpoints and options.
</Info>

***

<Note>
  You can also generate PDFs using any HTTP Request module by calling the pdf noodle API directly. See the [API Reference](/api-reference) for all available endpoints and options.
</Note>

## Resources

* [Make Integration Page](https://pdfnoodle.com/integrations/make) - pdf noodle + Make overview
* [Make Automation Guide](https://pdfnoodle.com/blog/how-to-automate-pdf-generation-with-make-and-pdforge) - Step-by-step tutorial
* [Make Documentation](https://www.make.com/en/help) - Official Make docs
* [pdf noodle API Reference](/api-reference) - Full API documentation