> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkadabra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure a Trigger

> Choose how and when your flow starts

# Configure a Trigger

A trigger defines **when the flow will run**. Prefer a single trigger per flow.

## Manual run

<Frame>
  <img src="https://mintcdn.com/kadabra/Bq0I86C4cP8x0NsL/images/Group153.png?fit=max&auto=format&n=Bq0I86C4cP8x0NsL&q=85&s=2308aaa2397597c517d0ee9a8c98d331" alt="Group153 Pn" width="1315" height="850" data-path="images/Group153.png" />
</Frame>

* Use the **Run** button on the Canvas to execute on demand.
* Ideal for testing or internal tools.

## Periodic schedule

<Frame>
  <img src="https://mintcdn.com/kadabra/Bq0I86C4cP8x0NsL/images/Group154.png?fit=max&auto=format&n=Bq0I86C4cP8x0NsL&q=85&s=dc796bd8660b610904f10fd5ccd65598" alt="Group154 Pn" width="1315" height="855" data-path="images/Group154.png" />
</Frame>

* After you **Publish**, choose a schedule such as hourly, daily, or weekly.
* Great for reports, syncs, and recurring jobs.

## Event based

<Steps>
  <Step title="Drag Conditional Trigger Node">
    <img src="https://mintcdn.com/kadabra/Bq0I86C4cP8x0NsL/images/Screenshot2025-10-14at8.59.58.png?fit=max&auto=format&n=Bq0I86C4cP8x0NsL&q=85&s=4483a364e409dbcbdd98d255ce2bb71a" alt="Screenshot2025 10 14at8 59 58 Pn" title="Screenshot2025 10 14at8 59 58 Pn" style={{ width:"48%" }} width="966" height="334" data-path="images/Screenshot2025-10-14at8.59.58.png" />
  </Step>

  <Step title="Press &#x22;Configure Trigger&#x22;" stepNumber={2}>
    <img src="https://mintcdn.com/kadabra/Bq0I86C4cP8x0NsL/images/Screenshot2025-10-14at9.01.03.png?fit=max&auto=format&n=Bq0I86C4cP8x0NsL&q=85&s=b0abbcab3c6418c47abc456a16b77efb" alt="Screenshot2025 10 14at9 01 03 Pn" title="Screenshot2025 10 14at9 01 03 Pn" style={{ width:"51%" }} width="2038" height="998" data-path="images/Screenshot2025-10-14at9.01.03.png" />
  </Step>

  <Step title="Define conditions">
    Define the condition that should trigger the flow in free text.

    <img src="https://mintcdn.com/kadabra/Bq0I86C4cP8x0NsL/images/Screenshot2025-10-14at9.03.10.png?fit=max&auto=format&n=Bq0I86C4cP8x0NsL&q=85&s=a2500df64b90bd7f2a4a32589630eb66" alt="Screenshot2025 10 14at9 03 10 Pn" title="Screenshot2025 10 14at9 03 10 Pn" style={{ width:"58%" }} width="1826" height="800" data-path="images/Screenshot2025-10-14at9.03.10.png" />
  </Step>

  <Step title="Your'e Ready!">
    Kadabra sets up a check that runs every 15 minutes. When the condition is met, your flow starts automatically.
  </Step>
</Steps>

<Info>
  Use this for reactive automations like new leads, new rows, or new messages.
</Info>

## API trigger

Expose your flow as an endpoint so external systems can start it.

<Steps>
  <Step title="Activate / Publish your flow">
    Activating or Publishing creates an API endpoint. Choose which inputs and outputs are exposed.
  </Step>

  <Step title="Open API docs">
    Return to the API dialog to copy the endpoint URL and code samples.

    <Frame>
      <img src="https://mintcdn.com/kadabra/-pN8DVIZS7d6I059/images/Screenshot2025-10-14at9.05.05.png?fit=max&auto=format&n=-pN8DVIZS7d6I059&q=85&s=d74c7bebce1d74ad45f3abd726661fdb" alt="Screenshot2025 10 14at9 05 05 Pn" width="996" height="308" data-path="images/Screenshot2025-10-14at9.05.05.png" />
    </Frame>
  </Step>

  <Step title="Call with API key">
    Use your API key to trigger the flow from any system.
  </Step>
</Steps>
