Molku.ai API Documentation

Zapier Integration

Make Integration


🚀 Getting Started with Zapier

Welcome to the official guide for integrating Molku with Zapier. This integration enables you to automate your workflows by connecting Molku's powerful document processing capabilities with thousands of other apps available on Zapier.

Integrating Molku with Zapier enables you to:

<aside> ⚡

Catch us on Zapier and start automating:

https://zapier.com/apps/molku/integrations

</aside>

Connect Molku to Make

  1. Log in to your Zapier account. If you’re new to Molku, sign up here.
  2. Navigate to the Settings tab, generate and copy your API Key.

Screenshot 2025-05-02 at 10.34.41.png

  1. Go to Zapier and create a new Zap. Add the Molku trigger or action, then sign in using your Molku account. When prompted, enter your API key to connect your Molku account to Zapier.

Screenshot 2025-05-02 at 14.29.53.png

Screenshot 2025-05-02 at 14.32.50.png

Once connected, you can start building scenarios using Molku triggers (e.g. workflow completion) and actions (e.g. run a workflow, retrieve output data).

In the following sections, we’ll guide you through each available action/trigger and its configuration.

⚙️ Actions

1. Run Workflow

Starts a specific document processing workflow in Molku by providing a direct link to your file, file name and Workflow ID. This action is used to trigger any "Ready to Run" workflow you’ve created in your Molku account. The workflow will process the input file and return either a success or failure status.

Screenshot 2025-05-02 at 14.47.02.png

You can also pass a file object from a previous step (e.g., from “Google Drive: New File”) in File URL field, which Zapier will automatically hydrate at runtime and convert into a usable file stream:

Screenshot 2025-05-02 at 14.59.21.png

Screenshot 2025-05-02 at 15.05.39.png

Input Parameters

Parameter Description
File URL A direct URL to the file that will be processed by the workflow. The link must point directly to the file (i.e. it should open/download the file without redirects or authentication). You can also pass the file object from previous step.
File Name The name of the output file.
Workflow ID The unique ID of the workflow to run. Must reference a workflow that is set to "Ready to Run" status. You can select a workflow from the dropdown list or enter the ID manually.

Upon calling the Run Workflow action, Molku returns an immediate response indicating whether the workflow has started successfully. The actual processing is asynchronous and continues in the background.

Output & Result Handling

When you call the Run Workflow action, Molku immediately returns a response indicating whether the workflow was successfully initiated. The document is processed asynchronously, and the final result becomes available shortly after.

Once the workflow has started, you have two ways to handle the output in Zapier:

📌 Option 1: Use a Webhook

If you've configured a webhook, Molku will automatically send the processed file data to that URL when the workflow is complete.

You can handle this using:

📌 Option 2: Use Scheduled Polling in Zapier

If you're not using webhooks, Zapier can poll Molku periodically for updates using the following triggers:

This approach lets you monitor workflow results even without setting up webhooks.

2. Get Output File

Retrieves a specific processed file from Molku using its unique file_id.

Screenshot 2025-05-02 at 16.15.30.png

Input Parameters

Parameter Description
File ID The unique ID of the file you want to retrieve. You can select a file_id from the dropdown, or enter it dynamically from an earlier action/trigger (e.g. webhook).

Output

Returns metadata and the direct URL to get the generated file.

| --- | --- |

⚙️ Triggers

1. New File Ready

Trigger when a workflow in your Molku account completes successfully and the output file is ready for use.