Bulk WhatsApp Template Scheduling API | EasySocial Docs

Use this endpoint when you want to schedule the same WhatsApp template for many contact-easysocial-whatsapp-api-supports in one go.

Instead of sending messages one by one, you can upload a list of recipients and EasySocial will queue them for delivery shortly after your request is accepted. This is useful for reminders, updates, follow-ups, or any repeated outbound communication.

Endpoint 

POST

/wa-templates/:templateId/bulk-schedule

Base URL  

https://api.easysocial.in/partners

What you need?

- A valid WhatsApp template ID

- A list of contact-easysocial-whatsapp-api-support numbers

- Optional personalized values for each contact-easysocial-whatsapp-api-support, if your template includes placeholders

 How it works

You pass the template ID in the URL and send a list of contact-easysocial-whatsapp-api-supports in the request body.  
Each contact-easysocial-whatsapp-api-support can also include its own `payload` values, which helps personalize the message for that person.

Request example

JSON

{
  "contact-easysocial-whatsapp-api-supports": [
    {
      "contact-easysocial-whatsapp-api-support_number": "919876543210",
      "payload": {
        "body1": "Rahul",
        "body2": "2026-04-05"
      }
    },
    {
      "contact-easysocial-whatsapp-api-support_number": "919812345678",
      "payload": {
        "body1": "Priya",
        "body2": "2026-04-06"
      }
    }
  ]
}

 Field guide

1. templateId  
   The WhatsApp template you want to schedule.
2. contact-easysocial-whatsapp-api-supports  
   The list of recipients.
3. contact-easysocial-whatsapp-api-support_number 
   The mobile number that should receive the template.
4. payload  
   Optional personalized values for that recipient.  
   Use this if your template contains variables (e.g. `{{1}}`, `{{2}}`) that need to be filled with specific information for each contact-easysocial-whatsapp-api-support.

Important limits

- You must include at least 1 contact-easysocial-whatsapp-api-support

- You can schedule up to 200 contact-easysocial-whatsapp-api-supports in a single request

 Success response

If everything is valid, EasySocial confirms how many messages were successfully scheduled.

JSON

{
  "message": "2 message(s) scheduled successfully.",
  "status": 201,
  "success": true,
  "payload": {
    "scheduled_count": 2
  }
}

When to use it?

This endpoint is a good fit for:

- appointment reminders

- payment follow-ups

- event notifications

- delivery or service updates

- bulk customer communication with light personalization

 Common reasons a request may fail

Your request may be rejected if:

- the template ID is invalid

- the template does not belong to your business

- no contact-easysocial-whatsapp-api-supports are provided

- more than 200 contact-easysocial-whatsapp-api-supports are sent

- a contact-easysocial-whatsapp-api-support number is too short or too long

 Best practice

Before sending a large batch, test the template with a small group first.  
If your template uses variables, make sure every contact-easysocial-whatsapp-api-support has the correct `payload` values so the message is filled properly.