# Webhook Trigger for Connectors

## Overview <a href="#overview" id="overview"></a>

Automatic webhook triggers enable your SaaS apps to notify you instantly, similar to push notifications on your phone. Unlike the Webhook Helper, there is no need for manual setup—Locoia handles everything for you in the background.

{% hint style="info" %}
All flows triggered this way run asynchronously (as if the "async" Webhook option was set), and the response is always `null` with a status code of `200`
{% endhint %}

Automatic webhook triggers are already enabled for various connectors. Upon request, we can add this feature to additional connectors that support automatic (API-based) setup quickly and easily.

## General usage <a href="#general-usage" id="general-usage"></a>

To configure and start your flow with any connector, simply type `trigger` in the connector's side panel, and the `Trigger by Webhook` action will be suggested automatically.

<figure><img src="https://291121471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McrRFZHYH27bqKzOVDd%2Fuploads%2F0R6XczpSoOeEr2bBtdEa%2Fimage.png?alt=media&#x26;token=e723a0ba-5f39-47f5-b82f-0c5c05a3b700" alt="" width="563"><figcaption><p>'Trigger by webhook' action</p></figcaption></figure>

## **Available Variables**

When setting up automatic webhooks, several variables are available to manage and utilize within your flows. Please note that this feature is available only to selected users who have the necessary permissions:

* `connectorAuth`: The authentication token from the connector where the webhook is triggered. It can be dynamically passed as `{{ connectorAuth }}` in the [lifecycle flow](https://docs.locoia.com/embed-white-label-portal/embed-admin-setup/flow-building/1.4-setting-up-callbacks-for-embed-activation-deactivation)
* `webhook_url`: The URL of the webhook for the flow where the webhook is triggered.
* `webhook_token`: The token for the webhook. This will be `None` if the webhook token is not enabled.

## Re-creating <a href="#re-creating" id="re-creating"></a>

Webhook triggers are re-created whenever their settings are changed. To re-create a webhook, simply modify a setting and save the flow. Then, revert the setting to its original value and save it again.

<figure><img src="https://291121471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McrRFZHYH27bqKzOVDd%2Fuploads%2FIuEIwGnESBJcj7FriHjE%2Fimage.png?alt=media&#x26;token=2ffb4906-ef97-4cf9-aba6-a21f60ef64e0" alt="" width="563"><figcaption><p>Webhook Settings</p></figcaption></figure>
