Lutra AI

If you’re using a tool or service that lets you craft custom HTTP requests (e.g., an internal system, a low-code platform, or a third-party app), you can integrate it with Lutra by making a POST request to the Webhook URL.

Webhook URL and Token from Lutra.

An application or service that can perform an HTTP POST with custom headers.

- Webhook URL and Token from Lutra.
- An application or service that can perform an HTTP POST with custom headers.

- From your chosen Playbook, click “Webhook.”
- Copy the <code>URL</code> and <code>X-Lutra-Webhook-Token</code>.

- In your external application, set the request method to POST.
- URL: Paste the Lutra-provided URL (e.g., <code>https://lutra.ai/api/webhooks/&lt;WEBHOOK_ID&gt;/runs</code>).
- Headers:
 - <code>Content-Type: application/json</code>
 - <code>X-Lutra-Webhook-Token: &lt;YOUR_TOKEN&gt;</code>
- Body: A JSON object containing the inputs to your Playbook, for example:
 { "condition": "heart attack", "destination_sheet": { "id": "1234567890abcdef", "mime_type": "application/vnd.google-apps.spreadsheet", "name": "Heart Attack Clinical Trials" } }

- A successful request returns a <code>201 Created</code> status. The JSON response contains:
 - <code>run_id</code>
 - <code>started_at</code>
 - <code>latest_event_at</code>
 - <code>user_requested_cancel_at</code>
 - <code>workflow_input</code>
 - <code>result</code> (this is null at first until the run completes)

- The <code>Location</code> header in the response points to a URL you can <code>GET</code> to see the updated run state. Use the same <code>X-Lutra-Webhook-Token</code> header.
- Once <code>result</code> is non-null, the run has finished.

1. Create a Webhook in Lutra
 - From your chosen Playbook, click “Webhook.”
 - Copy the <code>URL</code> and <code>X-Lutra-Webhook-Token</code>.
2. Configure an HTTP POST
 - In your external application, set the request method to POST.
 - URL: Paste the Lutra-provided URL (e.g., <code>https://lutra.ai/api/webhooks/&lt;WEBHOOK_ID&gt;/runs</code>).
 - Headers:
 - <code>Content-Type: application/json</code>
 - <code>X-Lutra-Webhook-Token: &lt;YOUR_TOKEN&gt;</code>
 - Body: A JSON object containing the inputs to your Playbook, for example:
 { "condition": "heart attack", "destination_sheet": { "id": "1234567890abcdef", "mime_type": "application/vnd.google-apps.spreadsheet", "name": "Heart Attack Clinical Trials" } }
3. Check Response
 - A successful request returns a <code>201 Created</code> status. The JSON response contains:
 - <code>run_id</code>
 - <code>started_at</code>
 - <code>latest_event_at</code>
 - <code>user_requested_cancel_at</code>
 - <code>workflow_input</code>
 - <code>result</code> (this is null at first until the run completes)
4. Polling for Completion (Optional)
 - The <code>Location</code> header in the response points to a URL you can <code>GET</code> to see the updated run state. Use the same <code>X-Lutra-Webhook-Token</code> header.
 - Once <code>result</code> is non-null, the run has finished.

Webhooks with HTTP Requests

Create a custom design with text, images, and links

Requirements

Steps