---
updatedAt: 2025-02-10T05:50:37.000Z
agentTools:
  projectIndex: https://developer.crazytel.io/llms.txt
---

# Send Bulk Sms

Send the same SMS message to multiple Australian mobile numbers from your verified number.

This endpoint allows sending bulk SMS messages using your account's verified caller ID number
as the sender. The same message will be sent to all recipient numbers.

## Parameters
* `from_number`: Your verified Caller ID number
* `to_numbers`: List of Australian mobile numbers
* `message`: The SMS content to send to all recipients

## Number Format Requirements
* Numbers must start with either '04' or '614'
* Examples of valid formats:
    * 0400000000
    * 61400000000

## Prerequisites
* You must have a verified Caller ID for the from_number
* You must have sufficient account credit balance
* You must have generated an SMS API key in the Crazytel portal

## Processing Details
* Total processing time depends on the number of recipients and API response times

## Returns
A list of results for each message attempt containing:
* to_number: The recipient number
* status: Success or failure status
* detail: Additional information about the result

## Notes
* Message charges apply for each recipient
* Numbers are automatically converted to E.164 format
* Each message may take several seconds to process

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Crazytel API System",
    "summary": "Crazytel's Communication API Platform",
    "description": "# Crazytel API Documentation\n\nWelcome to Crazytel's comprehensive communications API platform.\n\nOur API enables you to manage:\n- Phone Numbers\n- SIP Trunks\n- SMS Messaging\n- Account Settings and Verification\n- Balance Operations\n\n## Authentication\n\n### API Key Authentication:\n- Include X-Crazytel-Api-Key header: `X-Crazytel-Api-Key: your_api_key`\n- Or include api_key in request body: `{\"api_key\": \"your_api_key\"}`\n\n",
    "version": "1.0.0"
  },
  "paths": {
    "/api/v1/sms/bulk-send": {
      "post": {
        "tags": [
          "SMS",
          "SMS"
        ],
        "summary": "Send Bulk Sms",
        "description": "Send the same SMS message to multiple Australian mobile numbers from your verified number.\n\nThis endpoint allows sending bulk SMS messages using your account's verified caller ID number\nas the sender. The same message will be sent to all recipient numbers.\n\n## Parameters\n* `from_number`: Your verified Caller ID number\n* `to_numbers`: List of Australian mobile numbers\n* `message`: The SMS content to send to all recipients\n\n## Number Format Requirements\n* Numbers must start with either '04' or '614'\n* Examples of valid formats:\n    * 0400000000\n    * 61400000000\n\n## Prerequisites\n* You must have a verified Caller ID for the from_number\n* You must have sufficient account credit balance\n* You must have generated an SMS API key in the Crazytel portal\n\n## Processing Details\n* Total processing time depends on the number of recipients and API response times\n\n## Returns\nA list of results for each message attempt containing:\n* to_number: The recipient number\n* status: Success or failure status\n* detail: Additional information about the result\n\n## Notes\n* Message charges apply for each recipient\n* Numbers are automatically converted to E.164 format\n* Each message may take several seconds to process",
        "operationId": "send_bulk_sms_api_v1_sms_bulk_send_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkSMSRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SMSResult"
                  },
                  "type": "array",
                  "title": "Response Send Bulk Sms Api V1 Sms Bulk Send Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "BulkSMSRequest": {
        "properties": {
          "from_number": {
            "type": "string",
            "title": "From Number"
          },
          "to_numbers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "To Numbers"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "from_number",
          "to_numbers",
          "message"
        ],
        "title": "BulkSMSRequest"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "SMSResult": {
        "properties": {
          "to_number": {
            "type": "string",
            "title": "To Number"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "detail": {
            "type": "string",
            "title": "Detail"
          }
        },
        "type": "object",
        "required": [
          "to_number",
          "status",
          "detail"
        ],
        "title": "SMSResult"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-crazytel-api-key",
        "description": "API Key Authentication"
      }
    }
  },
  "servers": [
    {
      "url": "https://crazytel.io"
    }
  ]
}
```