2 months ago

Feature: add new API - Broadcast whatsapp template by tags and Broadcast whatsapp template by user ids

New API — Broadcast WhatsApp Template by Tags & by User IDs
Two new Sending API endpoints allow you to programmatically broadcast WhatsApp message templates to specific groups of subscribers — either by targeting a list of user IDs directly or by targeting subscribers with specific tags.
New Endpoints
MethodEndpointDescriptionPOST | /subscriber/broadcast-whatsapp-template-by-user-id | Broadcast a WhatsApp template to a specific list of user IDs
POST | /subscriber/broadcast-whatsapp-template-by-tag | Broadcast a WhatsApp template to all subscribers with matching tags
Full API docs:
Request Body — Broadcast by User IDs
{
  "user_id_list": "61412345678,61387625429,61245638917",
  "wa_template": {
    "namespace": "string",
    "name": "string",
    "lang": "string",
    "use_default_values": "yes",
    "params": {
      "HEADER_IMAGE": "https://example.com/image.png",
      "BODY_{{1}}": "text",
      "BODY_{{2}}": "text",
      "QUICK_REPLY_1": "sub flow ns",
      "URL_1": "https://example.com/url"
    }
  },
  "scheduled_time": 1786123679,
  "max_per_minute": 60
}
Request Body — Broadcast by Tags
{
  "tags": ["f123t456"],
  "exclude_tags": ["f123t568"],
  "wa_template": {
    "namespace": "string",
    "name": "string",
    "lang": "string",
    "use_default_values": "yes",
    "params": {
      "HEADER_IMAGE": "https://example.com/image.png",
      "BODY_{{1}}": "text",
      "QUICK_REPLY_1": "sub flow ns",
      "URL_1": "https://example.com/url"
    }
  },
  "scheduled_time": 1786123679,
  "max_per_minute": 60
}
Key Parameters
ParameterDescriptionuser_id_list | Comma-separated list of subscriber user IDs (by-user-id endpoint)
tags / exclude_tags | Array of tag IDs to include/exclude (by-tag endpoint)
wa_template.namespace / name / lang | Template identifiers — find these via /api/whatsapp-template/list
use_default_values | Set to "yes" to use template defaults, or provide custom params
scheduled_time | Unix timestamp for scheduled delivery (optional)
max_per_minute | Rate limit for sending (default: 60/min)
Scope Required
Manage Flow
Why It Matters
  • Enables fully programmatic WhatsApp template campaigns from external systems (CRMs, e-commerce platforms, n8n automations)
  • Tag-based targeting allows dynamic audience selection without hardcoding user IDs
  • exclude_tags support prevents duplicate sends to users who should be excluded
  • Scheduled delivery and rate limiting make it safe for large-scale broadcast operations
👉 Located at: API Docs → Sending → broadcast-whatsapp-template-by-user-id / broadcast-whatsapp-template-by-tag Published: March 24, 2026 at 6:28 am