Skip to main content
Make.com webhooks provide a powerful way to receive real-time notifications from the PDF.co API when specific operations are completed. This integration can significantly enhance your automation workflows in Make.com by eliminating the need for polling job statuses via Background Job Check. In this guide, we will walk through the process of setting up Make.com webhooks with PDF.co, including how to use the callback parameter via std_params in the profiles parameter.

​
Understanding PDF.co Webhooks

PDF.co supports webhooks for a variety of operations, allowing you to receive notifications when tasks such as document conversions or data extractions are finished. Instead of repeatedly checking the job status, you can set a callback URL to which PDF.co will send a POST request with the job results. To set up a webhook, you can use the callback parameter directly in your API calls. However, when integrating with automation platforms like Make.com, it’s often more convenient to use the std_params within the profiles parameter. The std_params allows you to define standard API parameters, including the callback URL, in a JSON format. For example, a request to PDF.co might include:

​
Setting Up Make.com Scenarios

If you’re using a custom webhook or callback endpoint (rather than Make.com webhooks), it must respond immediately within a few seconds. If it takes longer than 20–30 seconds, the PDF.co API will mark the callback as failed and retry up to 3 times.
To integrate PDF.co webhooks with Make.com, you’ll need to create two scenarios:
  1. Webhook Scenario: This scenario receives the callback from PDF.co.
  2. Request Scenario: This scenario initiates the PDF.co operation and sets the callback URL.

​
Creating the Webhook Scenario

  1. Create a new scenario.
  2. Select a Webhooks module and select Custom Webhook as the trigger.
Make.com - Custom Webhook
  1. Click “Add” and configure to accept POST requests, as PDF.co API sends callbacks via POST.
Make.com - Configure Webhook URL
  1. Make.com will generate a unique URL for your webhook. Copy this URL for use in the next scenario.
Make.com - Copy Webhook URL

​
Initiating the PDF.co Request

  1. Create another scenario in Make.com with an appropriate trigger (e.g., manual or scheduled).
  2. Add a PDF.co action module, selecting the desired operation (e.g., Convert From PDF).
  3. In the action module, click on the “Advance Options” and set the profiles parameter to include the std_params with the callback URL. The profiles parameter should be a string containing a JSON object, like this:
Make.com - Profiles Parameter
  1. Configure other parameters as needed for your specific PDF.co operation.

​
Processing the Callback

  1. In the webhooks scenario, after the “Custom Webhook” trigger, add actions to process the data received from PDF.co.
  2. The callback from PDF.co includes details such as the job ID, status, and output URL. Parse this data and integrate it with other apps in Make.com as required.