Skip to main content

Integration via Webhooks

Webhooks let external tools trigger a specific Lutra Playbook automatically.

Lutra avatar
Written by Lutra
Updated over a month ago

Instead of manually starting a Playbook, you can configure another application (like Zapier, a custom script, or an HTTP service) to call Lutra whenever new data is available, thereby automating your workflows.

How to Access Webhooks in Lutra

  1. Open a Playbook: Navigate to the Playbook you want to trigger externally.

  2. Click the “Webhook” Button: On the Playbook’s page, you’ll see a “Webhook” button. (See the screenshot you have showing where this button is located.)

  3. Copy the Instructions: A dialog box with the Webhook URL, a unique token, and usage instructions will appear. Note: Once you close this dialog, you must add a new webhook to see these instructions again.

  4. Set Up Your External Tool: Use the URL, token, and instructions to configure your external system (e.g., Zapier, a custom script, or cURL).

Tip: If you plan to connect multiple apps via webhooks, you can generate different webhook URLs (one per Playbook or scenario) for better tracking and security.

Core Concepts

  1. URL & Token

    • Every Lutra webhook has a unique URL and an X-Lutra-Webhook-Token.

    • Keep these confidential—anyone with the token can trigger your Playbook.

  2. Triggering the Run

    • Send a POST request to the webhook URL with your token in the header:

      X-Lutra-Webhook-Token: <YOUR_TOKEN_HERE>
    • Include a JSON body (if needed) to supply inputs to the Playbook.

  3. Checking Status

    • The response to creating a run contains a Location header.

    • GET that location (with the same token header) to see if the run is finished and fetch the result.

  4. Result & Logs

    • Once the run is complete, Lutra returns result data that you can retrieve.

    • Check your Lutra Chat or Logs (if available) for detailed operation history.

Did this answer your question?