Create Broadcast Voice | SchoolSet

curl -X POST https://app.schoolset.io/app/api/v1/broadcast/voice/create \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "academic_year_id": 2024,
  "recipients_id": [
    {
      "type": "student",
      "id": 12345,
      "grade_ids": [
        10,
        11
      ]
    }
  ],
  "sent_date": "2024-09-01T08:30:00-04:00",
  "subject": "Upcoming School Event Notification",
  "voice": "default_male_voice"
}'

{
  "status": "success",
  "message": "Voice broadcast created successfully.",
  "data": {
    "id": 98765,
    "academic_year": {
      "id": 2024,
      "title": "2024-2025 Academic Year"
    },
    "type": {
      "id": 2,
      "title": "Voice Broadcast",
      "sys_name": "voice_broadcast"
    },
    "method": {
      "id": 3,
      "sys_name": "automated_call"
    },
    "status": {
      "id": 1,
      "title": "Scheduled",
      "sys_name": "scheduled"
    },
    "from": {},
    "to": [
      {
        "id": 12345,
        "type": "student",
        "data": {
          "id": 12345,
          "name": "John Doe",
          "email": "johndoe@example.com",
          "cell_phone": "+15551234567"
        },
        "status": {
          "id": 1,
          "title": "Active",
          "sys_name": "active"
        },
        "grade_ids": [
          10,
          11
        ]
      }
    ],
    "sent_date": "2024-09-01T08:30:00-04:00",
    "subject": "Upcoming School Event Notification",
    "message": "Reminder: The school event will take place on September 10th at 6 PM.",
    "voice": {},
    "attributes": {
      "message": {},
      "document_template_recipients": [
        {}
      ],
      "form": {}
    },
    "form": {
      "id": 101
    },
    "statuses": [
      {}
    ],
    "attachments": [
      {
        "id": 501,
        "file_hash": "a1b2c3d4e5f67890",
        "file_name": "event_details.pdf",
        "file_original_name": "Event Details September.pdf",
        "file_mime_type": "application/pdf",
        "caption": "Event Details Document",
        "url": "https://app.schoolset.io/files/event_details.pdf",
        "file_size": 204800,
        "created_by": "admin_user",
        "created_at": "2024-08-25T10:00:00Z",
        "updated_at": "2024-08-25T10:00:00Z",
        "related_to": "broadcast",
        "model_name": "voice_broadcast",
        "model_id": 98765
      }
    ]
  }
}

Creates voice 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.

voicestringRequired

voice value.

broadcast_method_iddouble or nullOptional

broadcast method ID identifier.

attributesstring or nullOptional

Must be a valid JSON string.

Response

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

statusenum

Allowed values:

messagestring

dataobject