Create Staff Member | SchoolSet

curl -X POST https://app.schoolset.io/app/api/v2/staff/member/create \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "firstname": "Emily",
  "lastname": "Johnson"
}'

{
  "status": "success",
  "message": "Staff member created successfully.",
  "data": {
    "id": 1024,
    "school_staff_id": "SJ-2024-0456",
    "firstname": "Emily",
    "lastname": "Johnson",
    "full_name": "Emily Johnson",
    "firstname_hebrew": "אמילי",
    "lastname_hebrew": "ג'ונסון",
    "display_name": "Emily J.",
    "title": "Ms.",
    "suffix": "PhD",
    "home_phone": "+1-555-123-4567",
    "cell_phone": "+1-555-987-6543",
    "marital_status": {},
    "parent_student": {},
    "maiden_name": "Smith",
    "extension": "123",
    "email": "emily.johnson@schoolset.edu",
    "dob": "1985-04-12",
    "dob_hebrew": "5745-01-22",
    "gender": "female",
    "social_security_number": "123-45-6789",
    "date_of_hire": "2010-08-15",
    "date_of_termination": "",
    "addresses": [
      {}
    ],
    "positions": [
      {
        "id": 301,
        "academic_year": {
          "id": 2024,
          "title": "2023-2024 Academic Year"
        },
        "staff_position": {
          "id": 12,
          "name": "Mathematics Teacher",
          "created_by": "admin_user"
        },
        "staff_member_id": 1024,
        "is_main_teacher": true,
        "staff_position_status": {
          "id": 1,
          "title": "Active"
        },
        "start_date": "2023-09-01T08:00:00-04:00",
        "end_date": "2024-06-30T17:00:00-04:00",
        "created_by": "admin_user",
        "grades": [
          {
            "id": 9,
            "name": "Grade 9"
          }
        ],
        "classes": [
          {
            "id": 45,
            "name": "Algebra I"
          }
        ],
        "departments": [
          {
            "id": 3,
            "name": "Mathematics Department"
          }
        ],
        "department_nodes": [
          {
            "id": 7,
            "department_id": 3,
            "department_name": "Mathematics Department",
            "parent_node_id": 2
          }
        ]
      }
    ]
  }
}

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

firstnamestringRequired

firstname display value.

lastnamestringRequired

lastname display value.

firstname_hebrewstring or nullOptional

firstname hebrew display value.

lastname_hebrewstring or nullOptional

lastname hebrew display value.

phonestring or nullOptional

phone phone number.

emailstring or nullOptional

Must be a valid email address. Must not be greater than 255 characters.

dobstring or nullOptional

Must be a valid date. Must be a valid date in the format Y-m-d.

dob_hebrewstring or nullOptional

dob hebrew date value.

genderenumOptional

gender value.

Allowed values:

addresslist of objectsOptional

address list.

school_staff_idstring or nullOptional

school staff ID identifier.

display_namestring or nullOptional

display name display value.

titlestring or nullOptional

title display value.

suffixstring or nullOptional

suffix value.

home_phonestring or nullOptional

home phone phone number.

cell_phonestring or nullOptional

cell phone phone number.

marital_statusstring or nullOptional

marital status status value.

maiden_namestring or nullOptional

maiden name display value.

extensionstring or nullOptional

extension value.

social_security_numberstring or nullOptional

social security number value.

date_of_hirestring or nullOptional

date of hire date value.

date_of_terminationstring or nullOptional

date of termination date value.

marital_status_iddouble or nullOptional

marital status ID status value.

parent_student_iddouble or nullOptional

parent student ID identifier.

positionobject or nullOptional

position object.

Response

Success

statusenum

Allowed values:

messagestring

dataobject