---
title: "Create a new Guardian"
method: POST
path: "/guardian"
tags: ["Guardian"]
---

# Create a new Guardian

`POST /guardian`

Create a new Guardian

## Request body

- object
  - `external` ExternalRequest — ExternalRequest is the External-object used on Update and Create operations, since it should only be allowed to set SourceID, the Source-field is not included.
    - `sourceID` string, required — The ID of the external source
  - `identityNumber` string, required — The identity number of the guardian in the format YYYYMMDD-NNNN, must be unique within the organization.
  - `identityTemporary` boolean — If the identity number is temporary for the guardian
  - `firstName` string, required — The first name of the guardian
  - `lastName` string, required — The last name of the guardian
  - `address` Address — Address is a reusable object that can be used to store address information.
    - `postalAddress` string, nullable — The postal address of the address
    - `postalCode` string, nullable — The postal code (also known as ZIP or postcode) of the address, used together with the city to identify the delivery area.
    - `postalCity` string, nullable — The city of the address
    - `countryCode` string, nullable — The ISO 3166-1 alpha-3 country code of the address (e.g. "SWE" for Sweden).
    - `municipalityCode` string, nullable — The Swedish municipality (kommun) code for the address — a four-digit code as defined by Statistics Sweden (SCB), e.g. "0184" for Solna. Identifies the administrative municipality the address belongs to.
  - `emailAddress1` string, nullable — The email address of the guardian, will be used for communication with the guardian from the system and must be unique within the organization. Can be used to login to the system if password-authentication is enabled for the organization.
  - `emailAddress2` string, nullable — The secondary email address of the guardian, will not be used within the system, but will be displayed for contact information.
  - `phoneNumber1` string, nullable — The primary phone number of the guardian, will be used for communication with the guardian from the system.
  - `phoneNumber2` string, nullable — The secondary phone number of the guardian, will not be used within the system, but will be displayed for contact information.
  - `studentIDs` string[] — The IDs of the students the guardian is responsible for.

## Response `201`

Response for Guardian Create operation - returns the created Guardian

- Guardian — Guardian holds the information about a guardian of a student.
  - `id` string, uuid, required — Unique identifier for the Guardian
  - `meta` Meta — Meta contains information about the creation and modification of a resource for auditing purposes
    - `createdAt` string, date-time, required — Timestamp when the resource was created
    - `createdBy` string, uuid, nullable — User who created the resource
    - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
    - `updatedBy` string, uuid, nullable — User who last updated the resource
  - `external` External — External is a reusable object that can be used to store external information from another system, used for third-party integration tracking.
    - `sourceID` string, nullable — The ID of the external source
    - `source` string, nullable — The source of the external information
  - `identityNumber` string, required — The identity number of the guardian in the format YYYYMMDD-NNNN, must be unique within the organization.
  - `identityTemporary` boolean — If the identity number is temporary for the guardian
  - `firstName` string, required — The first name of the guardian
  - `lastName` string, required — The last name of the guardian
  - `address` Address — Address is a reusable object that can be used to store address information.
    - `postalAddress` string, nullable — The postal address of the address
    - `postalCode` string, nullable — The postal code (also known as ZIP or postcode) of the address, used together with the city to identify the delivery area.
    - `postalCity` string, nullable — The city of the address
    - `countryCode` string, nullable — The ISO 3166-1 alpha-3 country code of the address (e.g. "SWE" for Sweden).
    - `municipalityCode` string, nullable — The Swedish municipality (kommun) code for the address — a four-digit code as defined by Statistics Sweden (SCB), e.g. "0184" for Solna. Identifies the administrative municipality the address belongs to.
  - `emailAddress1` string, nullable — The email address of the guardian, will be used for communication with the guardian from the system and must be unique within the organization. Can be used to login to the system if password-authentication is enabled for the organization.
  - `emailAddress2` string, nullable — The secondary email address of the guardian, will not be used within the system, but will be displayed for contact information.
  - `phoneNumber1` string, nullable — The primary phone number of the guardian, will be used for communication with the guardian from the system.
  - `phoneNumber2` string, nullable — The secondary phone number of the guardian, will not be used within the system, but will be displayed for contact information.
  - `studentIDs` string[] — The IDs of the students the guardian is responsible for.

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid parameters
- `401` — Unauthorized - The request is missing valid authentication credentials
- `403` — Forbidden - Request is authenticated, but the user is not allowed to perform the operation
- `404` — Not Found - The requested resource does not exist
- `409` — Conflict - The request could not be completed due to a conflict
- `422` — Validation error for Guardian Create operation - request data failed validation
- `429` — Too Many Requests - When the rate limit has been exceeded
- `500` — Internal Server Error - An unexpected server error occurred

---

[API](https://skmtc.net/meitner/apis/directory-api.md) · [All operations](https://skmtc.net/meitner/apis/directory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meitner/directory-api/versions/014348a7bc35/schema)