# Broadcast WhatsApp Message Templates with Flow Builder & Postman

In this guide, you will learn how to broadcast any WhatsApp Messages Template with [Flow Builder](https://dashboard.messagebird.com/en/flow-builder) by creating a flow using a webhook as a trigger and [Postman](https://www.postman.com/downloads/) to trigger the webhooks.

* [Before you begin](#h_01F4VAAMRAVHAEJ0AAH8H11NAV)
* [Step 1: Create a webhook trigger flow ](#h_01F4VAAS2138EA082CRS91EBDE)
* [Step 2: Create a CSV list ](#h_01F4VAAXBGT4ET89E046X6C4Y8)
* [Step 3: Import contacts.csv into Postman](#h_01F4VAB29R19D5DC0H8W7ZKFF5)

### Before you begin <a href="#h_01f4vaamravhaej0aah8h11nav" id="h_01f4vaamravhaej0aah8h11nav"></a>

Before you get started, you will need to complete the following 3 steps first:&#x20;

* Create a business account by signing up with [MessageBird - WhatsApp Business Plan](https://www.messagebird.com/whatsapp/).&#x20;
* Submit your [pre-approved Message Templates](/connectivity-platform/getting-started/working-with-whatsapp-message-templates.md) via the [WhatsApp Template Manager](https://dashboard.messagebird.com/en/whatsapp-template-manager/) in your MessageBird Dashboard. You can use the following example as a guide:

E.g. *Hi **{{1}}**,*

*This is an automated system that helps facilitate your registration process through WhatsApp. Visit this link to find out what documents you need before we get started:* [*https://www.messagebird.com/en/*](https://www.messagebird.com/en/)

*Reply with Start when you're ready to proceed.*

* Install [Postman](https://www.postman.com/downloads/).&#x20;

&#x20;

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

\ <br>

### Step 1: Create a webhook trigger flow  <a href="#h_01f4vaas2138ea082crs91ebde" id="h_01f4vaas2138ea082crs91ebde"></a>

1\. Go to [Flow Builder](https://dashboard.messagebird.com/en/flow-builder) and **create a new flow**.&#x20;

2\. Select **Webhook** as the trigger.

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

&#x20;

3\. Add **phone** and **firstname** as your **webhook variables**.

<figure><img src="/files/1I0lV7cc7yJPvlbSHmAl" alt=""><figcaption></figcaption></figure>

\ <br>

4\. Done? Awesome! Add a **Send WhatsApp HSM** step below your Webhook.  Choose your template, add **phone** as the **Recipient**, and **firstname** as **variable 1**.

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

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

\ <br>

**5. Publish** your flow in the top-right corner of your screen, and you're good to go!&#x20;

&#x20;

### Step 2: Create a CSV list  <a href="#h_01f4vaaxbgt4et89e046x6c4y8" id="h_01f4vaaxbgt4et89e046x6c4y8"></a>

&#x20;1\. Create an excel or Google form. If you have an existing contact list, please update it like the following: &#x20;

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

\ <br>

Make sure the phone number starts with the country code.

2\. Save your file as **contacts.csv** when you are done. Don’t forget to save your file as a CSV format.&#x20;

&#x20;

### Step 3: Import contacts.csv into Postman <a href="#h_01f4vab29r19d5dc0h8w7zkff5" id="h_01f4vab29r19d5dc0h8w7zkff5"></a>

1\. Open your flow, click on the **Webhook** step and tap **copy.** Paste the **Flow Builder Webhook URL** into the request URL in **Postman**. The **HTTP Request Method** can be **GET** or **POST**.

&#x20;

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

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

\ <br>

2\. Copy **phone** and **firstname** from the **Configure webhook variables** section into **Query Params** as **KEY** values:&#x20;

* Type {{phone}} in the **phone** VALUE field&#x20;
* Type {{firstname}} in the **firstname** VALUE field.

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

&#x20;

<figure><img src="/files/3psZp5Z62GXntvoS4Nrm" alt=""><figcaption></figcaption></figure>

\
3\. Press **Save**. A **SAVE REQUEST** window will pop up, tap **+ Create Collection** and name it **WA Broadcast**. Once the new collection is created, save your request by clicking on the **Save to WA Broadcast** button.

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

<br>

&#x20;

<figure><img src="/files/8gq9lMyvUne1LqEOeom5" alt=""><figcaption></figcaption></figure>

\ <br>

4\. Choose **Runner** from the top row. A **Collection Runner** window will pop up, select your **WA Broadcast** collection — the saved request will populate into the **RUN ORDER**.<br>

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

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

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

\ <br>

5\. Click **Select File** and open **contacts.csv**.

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

\ <br>

6\. Click the **RUN WA Broadcast** button. **Runner** will then send the webhook request to the webhook flow following from the 1st row until the last row of the **contacts.csv** file.

&#x20;

#### Status:

* Passed: A green flag and **204 No Content**.
* Failed: A red flag and **400 Bad request**. If that’s the case, please make sure you did not miss any previous steps. &#x20;

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

And that’s it! 🎉Now you know how to broadcast any WhatsApp Message Templates through [Flow Builder](https://dashboard.messagebird.com/en/flow-builder) using [Postman](https://www.postman.com/downloads/).&#x20;


---

# 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/connectivity-platform/use-cases/broadcast-whatsapp-message-templates-with-flow-builder-and-postman.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.
