Class Manager
POST /v1/families/create

Create Family

application/json

Body

Request for creating a new Family

  • firstname string Required

    First name of the Primary Contact to add to the Family

  • lastname string Required

    Last name of the Primary Contact of the Family (will also be the Family name)

  • email string Required

    Email address of the Primary Contact to add to the Family

  • phone string | null

    Phone number of the Primary Contact to add to the Family

  • sendInvite boolean | null

    Whether we should also send an invitation to ClassManager to the Family

Responses

  • 200 application/json

    successful operation

    Hide response attributes Show response attributes object
    • id string Required

      id

    • companyId string Required

      Company ID

    • name string Required

      Name

    • joinedAt string(date) | null Required

      Joined at date

    • invitationStatus string Required

      Values are not_invited, invited, or accepted.

    • profilePicture string | null Required

      Profile Picture

    • deletedAt string(date-time) | null Required

      Deleted at date

    • archivedAt string(date-time) | null Required

      Archived at date

    • createdAt string(date-time) Required

      Created at date
  • 403 application/json

    Not authorized

    Hide response attributes Show response attributes object

    Error schema

    • statusCode number Required

      Status Code

    • messages array[string] Required

      List of error messages

    • exception object

      Exception
  • 422 application/json

    Validation error

    Hide response attributes Show response attributes object
    • statusCode number Required

      Status Code

    • messages array[string] Required

      List of error messages

    • exception object

      Exception
POST /v1/families/create 
curl \
 --request POST 'https://api.classmanager.io/v1/families/create' \
 --header "Content-Type: application/json" \
 --data '{"firstname":"Harry","lastname":"Potter","email":"h.potter@hogwarts.co.uk","phone":"01234567890","sendInvite":true}'
Request examples 
{
  "firstname": "Harry",
  "lastname": "Potter",
  "email": "h.potter@hogwarts.co.uk",
  "phone": "01234567890",
  "sendInvite": true
}
Response examples (200) 
{
  "id": "fml_123123123123",
  "companyId": "co_123123123123",
  "name": "Potter",
  "joinedAt": "2023-12-05",
  "invitationStatus": "not_invited",
  "profilePicture": "https://",
  "deletedAt": "2023-12-05 14:30:41",
  "archivedAt": "2023-12-05 14:30:41",
  "createdAt": "2023-12-05 14:30:41"
}
Response examples (403) 
{
  "statusCode": 42.0,
  "messages": [
    "string"
  ],
  "exception": {}
}
Response examples (422) 
{
  "statusCode": 42.0,
  "messages": [
    "string"
  ],
  "exception": {}
}