Create a registration phase

POST

https://ssuccessv2.com/app/api/v2/registration/phases/create

Creates a named registration phase with optional enrollment windows, discounts, ordering, and structure scopes.

AuthorizationBearer

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

This endpoint expects an object.

academic_year_idintegerRequired>=1

namestringRequired<=255 characters

registration_opensdatetime or nullOptional

registration_closesdatetime or nullOptional

registration_activebooleanOptional

early_bird_endsdatetime or nullOptional

early_bird_discountdouble or nullOptional

early_bird_discount_typeenum or nullOptional

Allowed values:

early_bird_contract_fees_type_idslist of integersOptional

full_payment_discountdouble or nullOptional

full_payment_discount_typeenum or nullOptional

Allowed values:

full_payment_contract_fees_type_idslist of integersOptional

sort_orderintegerOptional>=0

scopeslist of objectsOptional

Registration phase created

statusstringOptional

messagestringOptional

datamap from strings to anyOptional

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

$	curl -X POST https://ssuccessv2.com/app/api/v2/registration/phases/create \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"academic_year_id": 2026,
>	"name": "Fall enrollment",
>	"registration_active": false,
>	"sort_order": 1,
>	"scopes": [
>	{
>	"type": "grade",
>	"id": 12
>	}
>	]
>	}'

1	{
2	"status": "success",
3	"message": "Created successfully.",
4	"data": {
5	"id": 4,
6	"academic_year_id": 2026,
7	"name": "Fall enrollment",
8	"registration_active": false,
9	"sort_order": 1,
10	"scopes": []
11	}
12	}