Skip to main content

Bulk send from a CSV or Excel file

POST 
/api/v1/waba/messages/bulk

Multipart upload. The file needs a header row with a to column, one recipient per row, and may be CSV or .xlsx. Upload the workbook rather than exporting it first: a phone number in a General-formatted Excel cell exports to CSV as 2.55712E+11.

For type=template, reserved columns fill the template per row so a blast is not one identical message: var1..varN for the body, header, header_media_link, and button_0..button_9 for each button, so each recipient can get their own link. Any other column is ignored.

Each recipient is queued individually, so a row missing a required value is reported with its row index and the rest still go out. Track the batch with ?reference= or the batch summary.

Request​

Responses​

Batch accepted and queued