Schedule an SMS broadcast

POST

https://ssuccessv2.com/app/api/v1/broadcast/sms/create

POST

/app/api/v1/broadcast/sms/create

$ curl -X POST https://ssuccessv2.com/app/api/v1/broadcast/sms/create \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: multipart/form-data" \
>      -F academic_year_id='2026' \
>      -F broadcast_method_id='2' \
>      -F recipients_id='[
>   {
>     "type": "parent",
>     "id": 204,
>     "grade_ids": [
>       7
>     ]
>   }
> ]' \
>      -F sent_date='{}' \
>      -F subject="Attendance reminder" \
>      -F message="Greenfield Academy: please review today's attendance in SchoolSet."

1 {
2   "status": "success",
3   "message": "",
4   "data": {
5     "id": 732,
6     "subject": "Attendance reminder",
7     "message": "Greenfield Academy: please review today's attendance in SchoolSet.",
8     "sent_date": "2024-01-15T09:30:00Z",
9     "status": {
10       "id": 3,
11       "title": "Scheduled",
12       "sys_name": "scheduled"
13     },
14     "to": [
15       {
16         "id": 204,
17         "type": "parent"
18       }
19     ]
20   }
21 }

Creates an SMS broadcast for selected school recipients. The message is sent through the school’s configured Twilio service and may include a form link via form_id.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Request

This endpoint expects a multipart form.

academic_year_idintegerRequired

broadcast_method_idintegerOptional

recipients_idlist of objectsRequired

sent_datedatetimeRequired

subjectstringRequired

messagestringRequired

attributesstringOptional

JSON-encoded broadcast attributes

form_idintegerOptional

Response

SMS broadcast created

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error