Skip to main content

​
Introduction

Use Cradl AI’s Webhook export to send extracted data to a Make scenario. You can also fetch and download the original file inside Make.
A native Make integration is coming soon. Until then, connect via Webhook.

​
Before you begin

  • A Make account with permission to create scenarios
  • A Cradl AI agent with at least one test document
  • API client credentials (client_id, client_secret) from your workspace settings

​
Connect Cradl AI to Make

Create a Custom webhook in Make and point your agent’s Webhook export to it.
1

Add a Custom webhook in Make

In Make, create a new scenario and add the Webhooks app with the Custom webhook trigger. Click Add to create a new webhook, then copy the generated Webhook URL. Click Run once so the scenario is listening for a request.
2

Add a Webhook export in Cradl AI

In your agent, add a new export and choose Webhook. Paste the Make Webhook URL into URL and set HTTP Method to POST. Click Test webhook and verify that the Make scenario receives a request (2xx). The captured request establishes the webhook’s data structure in Make.

​
Payload format

The Webhook body includes extracted fields and context such as context.documentId. See the Webhook → Payload format for a full example.

​
Download the file in Make (optional)

Webhook payloads don’t include the original file. The steps below show how to get an access token, fetch the document metadata to obtain fileUrl, and then download the file.
1

Get an access token (HTTP → Make a request)

Add an HTTP > Make a request module and configure it to request an OAuth token.
ParameterValue
MethodPOST
URLhttps://auth.cradl.ai/oauth2/token
Body typex-www-form-urlencoded
BodySee table below
FieldValue
client_idyour client id here
client_secretyour client secret here
grant_typeclient_credentials
audiencehttps://api.cradl.ai/v1
Save access_token from the JSON response.
2

Fetch document metadata (get fileUrl)

Add another HTTP > Make a request module to fetch document metadata using the documentId from the Webhooks module output.
ParameterValue
MethodGET
URLhttps://api.lucidtech.ai/v1/documents/<Document ID from Webhooks body.context.documentId>
HeadersAdd Authorization: Bearer <access_token from previous step>
The response includes fileUrl.
3

Download the file

Add an HTTP > Get a file module (or use Make a request with file download enabled) to download the original file.
ParameterValue
URL{{fileUrl from previous step}}
HeadersAuthorization: Bearer <access_token>
The module returns the file as binary data, which you can pass to storage apps like Google Drive, OneDrive, or S3.

​
Best practices

  • Start the scenario in Run once mode when testing so Make captures the webhook sample and builds the data structure
  • Return a fast 2xx from your first steps; branch long-running work downstream
  • Store secrets in Make’s secure fields (e.g., module fields or variables) rather than hardcoding

​
Troubleshooting

  • No requests arriving in Make: verify the export URL and click Test webhook in Cradl AI; ensure the scenario is in Run once or scheduled
  • 401 from token or API calls: check client_id/client_secret, grant_type=client_credentials, and audience=https://api.cradl.ai/v1
  • Missing fields when mapping: run the scenario once to recapture the webhook payload and refresh the data structure
  • Cannot download file: include the Authorization: Bearer <ACCESS_TOKEN> header when requesting fileUrl
⌘I