Create a PTA event

POST

https://ssuccessv2.com/app/api/v1/pta/event/create

Creates a parent-teacher event, calculates its end time from school settings, and returns its generated schedule.

AuthorizationBearer

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

This endpoint expects a multipart form.

academic_year_idintegerRequired

titlestringRequired

start_datedatetimeRequired

pta_gap_parent_countintegerRequired

pta_schedule_type_idintegerRequired

pta_slot_duration_idintegerRequired

pta_slot_meeting_countintegerRequired

grade_idslist of integersOptional

class_idslist of integersOptional

staff_member_idslist of integersOptional

parent_typeenumOptionalDefaults to both

Allowed values:

exclude_staff_childrenintegerOptional

Created schedule or a PTA calculation/time business-rule error envelope.

statusstring

messagestring

datamap from strings to any

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X POST https://ssuccessv2.com/app/api/v1/pta/event/create \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F academic_year_id='2026' \
>	-F title="Fall parent-teacher conferences" \
>	-F start_date='{}' \
>	-F pta_gap_parent_count='2' \
>	-F pta_schedule_type_id='1' \
>	-F pta_slot_duration_id='3' \
>	-F pta_slot_meeting_count='12'