# Webhook triggers

A webhook trigger is a way for you to notify MessageBird about events that occur in an external system.

During the setup of a webhook trigger, we'll generate a URL that accepts POST calls with JSON-formatted payloads.

You can copy this URL and add it to your app.

The app that's connected to your MessageBird webhook will send data to it whenever something new is added.

MessageBird will receive the data from your app, and you will be able to use it to perform actions in a flow.

## Set up a webhook trigger

To set up a webhook trigger, select the **Webhook** trigger type.

<figure><img src="/files/GMSQHu9ornqQyMrbKW3v" alt=""><figcaption></figcaption></figure>

### Test the webhook trigger

{% hint style="info" %}
When testing the webhook trigger, use a JSON file in the format that you want to use when executing the flow.
{% endhint %}

In the "Try it" section, edit the test payload, then click **Update test data** > **Send**.&#x20;

If the test was successful, you will be able to see the payload in the "Test output" section below.

Click **Save** to finish setting up your webhook trigger.

<figure><img src="/files/WoNLqzUzh240AESV1rLe" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/applications/automation/flows/concepts/triggers/webhook-triggers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
