Create a staff member

POST

https://ssuccessv2.com/app/api/v2/staff/member/create

POST

/app/api/v2/staff/member/create

$ curl -X POST https://ssuccessv2.com/app/api/v2/staff/member/create \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "firstname": "Sarah",
>   "lastname": "Cohen",
>   "email": "sarah.cohen@example.com",
>   "gender": "female",
>   "position": {
>     "new": [
>       {
>         "academ_year_id": 2026,
>         "staff_position_id": 3,
>         "is_main_teacher": true,
>         "staff_position_status_id": 1,
>         "start_date": {},
>         "end_date": null,
>         "classes": [
>           44
>         ],
>         "grades": [
>           8
>         ]
>       }
>     ]
>   }
> }'

1 {
2   "status": "success",
3   "message": "Saved",
4   "data": {
5     "id": 104,
6     "firstname": "Sarah",
7     "lastname": "Cohen",
8     "full_name": "Sarah Cohen",
9     "positions": []
10   }
11 }

Creates a staff member, optionally including addresses, parent-student linkage, and academic-year positions.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

firstnamestringRequired

lastnamestringRequired

emailstringOptionalformat: "email"

genderenumOptional

Allowed values:

dobdateOptional

school_staff_idstringOptional

phonestringOptional

positionobjectOptional

addresslist of objectsOptional

Response

The staff member was created and the saved staff resource was returned.

statusstringOptional

messagestringOptional

datamap from strings to anyOptional

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error