message.batch

message.batch is emitted when a batch has no pending messages left and at least one message in that batch reached SENT.

{
  "id": "748395130237498912",
  "createdAt": "2026-03-19T18:42:25.000Z",
  "sandbox": false,
  "type": "message.batch",
  "data": {
    "id": "748395130237498700",
    "projectId": "748395130237498412",
    "ids": [
      "748395130237498500",
      "748395130237498501",
      "748395130237498502"
    ]
  }
}

Notes:

sandbox on the envelope tracks the mode of the project that produced the batch.
data.id is the batch id.
data.ids are the stored message ids that finished with SENT, sorted ascending.
data.ids can be longer than the original number of request items when some entries were segmented into multiple SMS parts.
If every batch item fails, no message.batch event is emitted.

Reference

Events