1. Students
ScuolaSemplice Web API
  • v2
    • Payments
      • registerInstallmentPayment
    • Orders
      • fetchUserOrders
    • Aggregator
      • Update timetable
      • Booking lesson
      • Cancel booking
      • Set attendances
    • Custom fields
      • Read all custom fields
      • Fetch ustom field
    • Workflows
      • Returns list of all workflows
      • Start a new workflow instance
    • StudyPlans
      • Returns list of all study plans
    • Subscriptions
      • fetchSubscriptions
      • Subscribe a student to a class
      • Alter subscriprion of a student to a class
    • Classes
      • Retuns list of class models
      • Creates a class model / catalogue
      • Updates a class model / catalogue
      • Creates a class from a model
      • Reads all list of classes from archive
      • Reads all classes added or updated after timestamp
    • Students
      • Reads paginated list of students
        GET
      • Fetch student
        GET
      • Creates new student and return the id
        POST
      • Updates an existing student and return the id
        PUT
      • Reads all list of students from archive
        GET
      • Reads all students added or updated after timestamp
        GET
    • Catalogues
      • Returns list of system branches
      • Returns list of classes custom fields
      • Returns list of all locations
  • v3
    • Classes
      • classes
      • classes/{id}
    • Exams
      • exams
      • exams/{id}
    • Lessons
      • lessons
      • lessons/{id}
    • Orders
      • orders
      • orders/{id}
      • Order creation
    • PackageOffers
      • packageoffers
      • packageoffers/{id}
    • ProfileCustomSelectValues
      • profilecustomselectvalues
    • Payments
      • payments
      • payments/{id}
    • QrReadings
      • qrreadings
      • qrreadings/{id}
      • qrreadings
    • Students
      • students
      • students/{id}
      • create
      • update
      • update by externid
      • create student comment
    • Teachers
      • teachers/{id}
      • teachers
      • create
      • update
      • update by externid
    • CustomerCompanies
      • customercompanies
      • customercompanies/{id}
    • Subscriptions
      • classes
        • subscriptions/classes
        • subscriptions/classes/{id}
        • create subscription class
      • exams
        • subscriptions/exams
        • subscriptions/exams/{id}
        • create subscription exam
      • studyplans
        • subscriptions/studyplans
        • subscriptions/studyplans/{id}
    • Tutors
      • tutors
      • tutors/{id}
    • Transactions
      • Create
      • Delete
    • TeacherPayments
      • List teacher payments
      • Get a teacher payment by id
    • subscriptions
      GET
  • Schemas
    • Schemas
      • Generic key value parameters
      • Generic parameters array
      • CustomFieldValue
      • user
      • inline_response_200
      • parameters_1
      • parameters_2
      • parameters_3
      • inline_response_200_1
      • parameters_4
      • parameters_5
      • parameters_6
    • Aggregator
      • Lesson
      • Course timetable
      • Attendance
    • ErrorBadRequest
    • StudyPlan
    • TeacherPaymentLine
    • TeacherPayment
    • PaginationLinks
    • PaginationMeta
    • TeacherPaymentCollection
  1. Students

Creates new student and return the id

POST
api/v2/newstudent
Last modified:2026-01-21 10:08:58

Request

Authorization
Basic Auth
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/json

Example
{
    "branchid": 0,
    "name": "string",
    "surname": "string",
    "email": "string",
    "phone": "string",
    "mobile": "string",
    "taxcode": "string",
    "datebirth": "2000-05-17",
    "gender": "male",
    "address": "string",
    "cap": "string",
    "city": "string",
    "province": "string",
    "country": "string",
    "birthplace": "string",
    "birthprovince": "string",
    "birthcountry": "string",
    "externid": 0,
    "externuuid": "string",
    "ssoemail": "string",
    "customfields": [
        {
            "fieldid": 0,
            "value": "string",
            "valueid": 0
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://prod.your-api-server.comapi/v2/newstudent' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "branchid": 0,
    "name": "string",
    "surname": "string",
    "email": "string",
    "phone": "string",
    "mobile": "string",
    "taxcode": "string",
    "datebirth": "2000-05-17",
    "gender": "male",
    "address": "string",
    "cap": "string",
    "city": "string",
    "province": "string",
    "country": "string",
    "birthplace": "string",
    "birthprovince": "string",
    "birthcountry": "string",
    "externid": 0,
    "externuuid": "string",
    "ssoemail": "string",
    "customfields": [
        {
            "fieldid": 0,
            "value": "string",
            "valueid": 0
        }
    ]
}'

Responses

🟢200ID of new student
application/json
Bodyapplication/json

Example
{
    "success": 0,
    "id": 0
}
Modified at 2026-01-21 10:08:58
Previous
Fetch student
Next
Updates an existing student and return the id
Built with