POST /api/v2/message/bulk
Sends a bulk message to multiple recipients (up to 50).
This endpoint allows you to send the same message to multiple phone numbers. All existing logic (including spam checks, delivery behavior, and visibility in the Bulk Messages UI tab) will remain the same for API-triggered sends.
Important: Message sending is asynchronous. This endpoint creates the bulk message batch and returns immediately with success=True, indicating the batch was created successfully. Individual messages are sent in the background. To check the delivery status of individual recipients, use the GET /message/bulk/{id} endpoint to retrieve the batch with delivery status information (attempted_send, error_message, delivery_status fields per recipient).
Added on Dec 28, 2025 for API v2.
Rate limit: 1200 per minute.
Servers
- https://dialpad.com/
- https://sandbox.dialpad.com/
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
text |
Null | Yes |
The message text content (required). |
media |
Null | No |
Base64-encoded media attachment for MMS (images/videos, max 500 KiB raw file size). |
title |
Null | No |
Optional title for the bulk message batch. |
from_number |
Null | Yes |
The phone number to use as sender (must belong to the user and be A2P-registered). |
to_numbers[] |
Array | Yes |
List of phone numbers in E.164 format (max 50). |
user_id |
Integer | No |
The ID of the user who should be the sender. Defaults to authenticated user. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.