Create Broadcast SMS | SchoolSet

curl -X POST https://app.schoolset.io/app/api/v1/broadcast/sms/create \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "academic_year_id": 2024,
  "recipients_id": [
    {
      "type": "student",
      "id": 42,
      "grade_ids": [
        10,
        11
      ]
    }
  ],
  "sent_date": "2026-05-06T17:42:52-04:00",
  "subject": "Upcoming School Event",
  "message": "Dear parents, please be reminded of the school event scheduled for next week."
}'

{
  "status": "success",
  "message": "Broadcast SMS created successfully.",
  "data": {
    "id": 12345,
    "academic_year": {
      "id": 2024,
      "title": "2024-2025 Academic Year"
    },
    "type": {
      "id": 2,
      "title": "SMS Broadcast",
      "sys_name": "sms_broadcast"
    },
    "method": {
      "id": 1,
      "sys_name": "sms"
    },
    "status": {
      "id": 3,
      "title": "Sent",
      "sys_name": "sent"
    },
    "from": {},
    "to": [
      {
        "id": 42,
        "type": "student",
        "data": {
          "id": 42,
          "name": "John Doe",
          "email": "johndoe@example.com",
          "cell_phone": "+1234567890"
        },
        "status": {
          "id": 3,
          "title": "Active",
          "sys_name": "active"
        },
        "grade_ids": [
          10,
          11
        ]
      }
    ],
    "sent_date": "2026-05-06T17:42:52-04:00",
    "subject": "Upcoming School Event",
    "message": "Dear parents, please be reminded of the school event scheduled for next week.",
    "voice": {},
    "attributes": {
      "message": {},
      "document_template_recipients": [
        {}
      ],
      "form": {}
    },
    "form": {
      "id": 17
    },
    "statuses": [
      {}
    ],
    "attachments": [
      {
        "id": 101,
        "file_hash": "a1b2c3d4e5f67890",
        "file_name": "event_flyer.pdf",
        "file_original_name": "School_Event_Flyer.pdf",
        "file_mime_type": "application/pdf",
        "caption": "Event Flyer",
        "url": "https://app.schoolset.io/files/event_flyer.pdf",
        "file_size": 204800,
        "created_by": "admin_user",
        "created_at": "2024-04-01T09:00:00Z",
        "updated_at": "2024-04-01T09:00:00Z",
        "related_to": "broadcast_sms",
        "model_name": "BroadcastSMS",
        "model_id": 12345
      }
    ]
  }
}

Creates sms create data from submitted details.

Authentication

AuthorizationBearer

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Request

This endpoint expects an object.

academic_year_iddoubleRequired

academic year ID identifier.

recipients_idlist of objectsRequired

recipients ID identifier.

sent_datestringRequired

Must be a valid date. Must be a valid date in the format Y-m-d\TH:i:sP.

subjectstringRequired

subject value.

messagestringRequired

message value.

broadcast_method_iddouble or nullOptional

broadcast method ID identifier.

form_idinteger or nullOptional

form ID identifier.

attributesstring or nullOptional

Must be a valid JSON string.

Response

Successful POST response for /api/v1/broadcast/sms/create.

statusenum

Allowed values:

messagestring

dataobject