---
url: https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/bulk-campaign.md
description: >-
  Send WhatsApp messages to thousands of contacts at once with WhatsMark SaaS
  Bulk Campaign. Upload CSV recipient lists, map dynamic variables, preview
  messages, and dispatch through Meta's official Cloud API.
---

# Bulk Campaign

The **Bulk Campaign feature in WhatsMark** allows you to send WhatsApp messages to many recipients at once by uploading a CSV file that contains their contact information. This tool helps you save time and effort by automating marketing messages, notifications, and other important communications.

:::warning **-> IMPORTANT NOTES**

***

\=> Please Read These Limitations Carefully Before Proceeding:

1. **Only Passed Count Shown:**

   * After the sending process is completed, the system will display **only the number of successfully processed senders**. It will not show details about which specific contacts succeeded or failed.

2. **No Delivery Report:**

   * The system does **not generate a delivery report**. You won’t receive a breakdown of which messages were delivered, failed, or bounced.

3. **Server Timeout or Crash:**

   * When sending to a large number of contacts, there's a risk that the process may **timeout or cause the server to crash**, especially on shared or low-resource hosting environments. To reduce the risk, ensure your server has adequate memory and execution time limits.

4. **PHP Timeout Issue:**

   * If you're facing a PHP timeout issue, you need to **increase the PHP execution time limit**. This typically requires server-side changes, so please **contact your hosting provider or server administrator** to make the necessary adjustments.

5. **No Batching – All at Once:**

   * Once you initiate a bulk import, our system will process **all contacts in one go**. For example, if your CSV file contains 5,000 records, the system will attempt to process **all 5,000 records in a single operation**.
   * This behavior is entirely dependent on the type of **server and available resources** you have. There is **no built-in script limitation**, but performance issues (like timeouts or crashes) may occur on low-resource servers.

6. **Requires Clean CSV:**
   * Your CSV file must be **properly formatted**. Any issues in the structure — such as missing headers, incorrect columns, or unsupported characters — may cause the upload or sending process to fail.
   * We **highly recommend** downloading our **sample CSV file**, editing it with your own records, and then uploading it. This helps eliminate most common file formatting errors and ensures a smooth import.

:::

## How to Create a New Bulk Campaign

Follow these simple steps to create and send your bulk WhatsApp messages:

### Visual Guide

Here’s how the campaign creation screen looks:

![csv-campaign](../images/bulk-campaign/csv-campaign.png)

And here’s the screen where you can set dynamic variables and preview the message content:

![csv-campaign](../images/bulk-campaign/csv.png)

### 1. Enter Campaign Name

First, you need to give your campaign a name. This name will help you identify the campaign later on.

* Example: `Summer Sale 2025` or `Newsletter June`

Simply type the name into the **Campaign Name** input box.

### 2. Upload CSV File with Recipient Details

To send bulk messages, you must upload a CSV file containing the list of recipients and their details.

* The CSV file should contain columns such as phone numbers and any other information you want to use for personalization (like names, order IDs, etc.).
* Make sure the file format is correct. You can download a sample CSV file and instructions to help you prepare your file correctly.

You can upload your CSV file by:

* Dragging and dropping the file into the dashed upload box, **or**
* Clicking inside the box to browse and select the file from your computer.

**Important:** Only CSV files are allowed in this section.

:::warning **CSV Format Requirements**

***

##### Mandatory Columns

* **FIRST NAME** *(required)*
* **LAST NAME** *(required)*
* **PHONE** *(required)* – must include the country code and a `+` sign (e.g., `+1 555 123 4567`)
* **EMAIL** *(optional but recommended)*
* **COUNTRY** *(optional)*

##### Header Row

The **first row** of the CSV must contain the exact column headers as shown above.

##### Encoding

The file must be encoded in **UTF-8** to avoid encoding issues.

![csv-format](../images/bulk-campaign/csv-format.png)

***

##### Example (as shown in the image)

```csv
FIRST NAME,LAST NAME,PHONE,EMAIL,COUNTRY
Sample Data,Sample Data,+1 555 123 4567,abc@gmail.com,Sample Data
```

:::

### 3. Choose a Message Template

WhatsApp requires using pre-approved message templates for bulk messaging. After uploading your CSV file, select the appropriate message template from the dropdown menu.

* These templates include fixed text and placeholders for dynamic content.
* Choosing the correct template ensures your messages comply with WhatsApp policies and get delivered successfully.

### 4. Set Dynamic Variables

Many templates include placeholders for personalized data, such as `name` or `order_number`. To customize each message for individual recipients:

* Map the dynamic variables in your template to the columns in your CSV file.
* For example, if your template says, "Hello `name`!", and your CSV has a column named `name`, each message will replace `name` with the `actual recipient's name` from the CSV.

This personalization helps your messages feel more personal and increases customer engagement.

### 5. Preview Your Message

Before sending your campaign, you can preview the message to see exactly how it will appear to your recipients.

* The preview shows how the dynamic variables are replaced with real data.
* This helps catch any errors or formatting issues before the messages are sent.

## Final Preview

Below is a video demonstration showing the final appearance of the bulk WhatsApp messages as they will be received by your customers: