> For the complete documentation index, see [llms.txt](https://guide.fariaedu.com/integrations-portal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.fariaedu.com/integrations-portal/managebac/public-rest-apis/v2p2/parents.md).
# Parents
Parents are users who are adults connected to students
## Get all Parents
> Retrieves all parent records for the school. Returns personal details, contact information, and the IDs of their associated students (children).\
> \
> Results are paginated and can be filtered by archive status, modification date, deletion date, or a search query.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"parameters":{"idsQueryParam":{"name":"ids[]","in":"query","description":"Return only records with the given IDs.","required":false,"allowReserved":true,"style":"form","explode":true,"schema":{"type":"array","items":{"type":"integer"}}}},"schemas":{"Parent":{"anyOf":[{"$ref":"#/components/schemas/PersonalInformation"},{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID for a parent in ManageBac."},"salutation":{"type":"string","description":"Parent/guardian’s title.","enum":["Mr.","Ms.","Mrs.","Dr."]},"title":{"type":"string","description":"Parent/guardian’s work position."},"employer":{"type":"string","description":"Parent/guardian’s employer."},"work_email":{"type":"string","description":"Parent/guardian’s work email address (may differ to email field)."},"work_phone":{"type":"string","description":"Parent/guardian’s work number."},"work_address":{"type":"string","description":"First line of parent/guardian’s work address."},"work_address_ii":{"type":"string","description":"Second (optional) line of parent/guardian’s work address."},"work_fax":{"type":"string","description":"Fax number for parent/guardian’s work"},"work_city":{"type":"string","description":"City of parent/guardian’s work address."},"work_state":{"type":"string","description":"State of parent/guardian’s work address."},"work_postal_code":{"type":"string","description":"Postal/zip code of parent/guardian’s work address."},"work_country":{"type":"string","description":"Country of parent/guardian’s address."},"sb_id":{"type":"string","description":"SchoolsBuddy uniq ID"},"oa_id":{"type":"string","description":"OpenApply uniq ID"},"child_ids":{"type":"array","readOnly":true,"items":{"type":"integer"},"description":"Unique ID for offspring/wards of the parent/guardian."}}}]},"PersonalInformation":{"type":"object","description":"Common personal and contact fields shared by Teacher, Student, and Parent schemas. On POST (create), email and last_name are required. On PATCH (update), only include fields you want to change.\n","properties":{"email":{"type":"string","description":"User’s primary email address. Used for login and notifications. Required on create."},"first_name":{"type":"string","description":"User’s first given name."},"middle_name":{"type":"string","description":"User’s additional name."},"password":{"type":"string","description":"Minimum 6-character password. Only used on POST (create) and PATCH (update). Never returned in GET responses. If omitted on create, a random password is generated and the user receives a welcome email.\n"},"last_name":{"type":"string","description":"User’s surname."},"nickname":{"type":"string","description":"User’s handle (may differ to given name)."},"other_name":{"type":"string","description":"User’s additional names or variant in a different language."},"identifier":{"type":"string","description":"School’s own unique ID for user."},"gender":{"type":"string","description":"The user's gender. Accepts \"Male\", \"Female\", or other values depending on school configuration."},"birthday":{"type":"string","description":"User’s dob; yyyy-mm-dd."},"phone_number":{"type":"string","description":"User’s home number."},"mobile_phone_number":{"type":"string","description":"User’s mobile number."},"street_address":{"type":"string","description":"First line of user’s home address."},"street_address_ii":{"type":"string","description":"Second (optional) line of user’s home address."},"city":{"type":"string","description":"City of user’s home address."},"state":{"type":"string","description":"State of user’s home address."},"zipcode":{"type":"string","description":"Postal/zip code of user’s home address."},"country":{"type":"string","description":"Country of user’s home address."},"nationalities":{"type":"array","description":"One or more nationalities of the user.","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"},"description":"Fluent language/s of the user."},"account_uid":{"type":"string","readOnly":true,"description":"A user's Portal Account UID"},"timezone":{"type":"string","description":"The time zone of the user."}}},"Meta":{"type":"object","description":"Pagination metadata included in all list (index) responses.","properties":{"current_page":{"type":"integer","description":"The page number of the current result set, starting from 1."},"total_pages":{"type":"integer","description":"The total number of pages available for this query."},"total_count":{"type":"integer","description":"The total number of records matching the query across all pages."},"per_page":{"type":"integer","description":"The number of records returned per page. Defaults to 100; can be overridden with the per_page query parameter (max 200)."}}},"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}}}},"paths":{"/v2p2/parents":{"get":{"summary":"Get all Parents","operationId":"listParents","tags":["Parents"],"description":"Retrieves all parent records for the school. Returns personal details, contact information, and the IDs of their associated students (children).\n\nResults are paginated and can be filtered by archive status, modification date, deletion date, or a search query.\n","parameters":[{"$ref":"#/components/parameters/idsQueryParam"},{"name":"archived","in":"query","description":"Return only archived (1) or only active (0) parents. If value is not specified, all parents are returned.","required":false,"schema":{"type":"boolean"}},{"name":"modified_since","in":"query","description":"An ISO 8601 timestamp to filter parents modified on or after this date.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"An integer defining which page to display. Defaults to 1.","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","description":"An integer defining the number of records to display per page. Defaults to 100.","required":false,"schema":{"type":"string"}},{"name":"deleted_since","in":"query","description":"An ISO 8601 timestamp to filter parents deleted on or after this date. Returns soft-deleted records.","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"A search string matched against parent name, email, and other fields.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"parents":{"type":"array","items":{"$ref":"#/components/schemas/Parent"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}}}}}}}
```
## Create New Parent
> Creates a new parent record. The \Content-Type\ header must be set to \application/json\,\
> and the request body should contain the parent fields as a JSON payload.\
> \
> Only users with the \admin\ role are able to create parent accounts. An \email\ address is required.\
> Optionally, \child\_ids\ can be provided to link the parent to existing students.\
> \
> Pass \options\[send\_welcome\_email]: true\ to enqueue a welcome email (with password-set link) to the new parent. Defaults to \false\.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"Parent":{"anyOf":[{"$ref":"#/components/schemas/PersonalInformation"},{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID for a parent in ManageBac."},"salutation":{"type":"string","description":"Parent/guardian’s title.","enum":["Mr.","Ms.","Mrs.","Dr."]},"title":{"type":"string","description":"Parent/guardian’s work position."},"employer":{"type":"string","description":"Parent/guardian’s employer."},"work_email":{"type":"string","description":"Parent/guardian’s work email address (may differ to email field)."},"work_phone":{"type":"string","description":"Parent/guardian’s work number."},"work_address":{"type":"string","description":"First line of parent/guardian’s work address."},"work_address_ii":{"type":"string","description":"Second (optional) line of parent/guardian’s work address."},"work_fax":{"type":"string","description":"Fax number for parent/guardian’s work"},"work_city":{"type":"string","description":"City of parent/guardian’s work address."},"work_state":{"type":"string","description":"State of parent/guardian’s work address."},"work_postal_code":{"type":"string","description":"Postal/zip code of parent/guardian’s work address."},"work_country":{"type":"string","description":"Country of parent/guardian’s address."},"sb_id":{"type":"string","description":"SchoolsBuddy uniq ID"},"oa_id":{"type":"string","description":"OpenApply uniq ID"},"child_ids":{"type":"array","readOnly":true,"items":{"type":"integer"},"description":"Unique ID for offspring/wards of the parent/guardian."}}}]},"PersonalInformation":{"type":"object","description":"Common personal and contact fields shared by Teacher, Student, and Parent schemas. On POST (create), email and last_name are required. On PATCH (update), only include fields you want to change.\n","properties":{"email":{"type":"string","description":"User’s primary email address. Used for login and notifications. Required on create."},"first_name":{"type":"string","description":"User’s first given name."},"middle_name":{"type":"string","description":"User’s additional name."},"password":{"type":"string","description":"Minimum 6-character password. Only used on POST (create) and PATCH (update). Never returned in GET responses. If omitted on create, a random password is generated and the user receives a welcome email.\n"},"last_name":{"type":"string","description":"User’s surname."},"nickname":{"type":"string","description":"User’s handle (may differ to given name)."},"other_name":{"type":"string","description":"User’s additional names or variant in a different language."},"identifier":{"type":"string","description":"School’s own unique ID for user."},"gender":{"type":"string","description":"The user's gender. Accepts \"Male\", \"Female\", or other values depending on school configuration."},"birthday":{"type":"string","description":"User’s dob; yyyy-mm-dd."},"phone_number":{"type":"string","description":"User’s home number."},"mobile_phone_number":{"type":"string","description":"User’s mobile number."},"street_address":{"type":"string","description":"First line of user’s home address."},"street_address_ii":{"type":"string","description":"Second (optional) line of user’s home address."},"city":{"type":"string","description":"City of user’s home address."},"state":{"type":"string","description":"State of user’s home address."},"zipcode":{"type":"string","description":"Postal/zip code of user’s home address."},"country":{"type":"string","description":"Country of user’s home address."},"nationalities":{"type":"array","description":"One or more nationalities of the user.","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"},"description":"Fluent language/s of the user."},"account_uid":{"type":"string","readOnly":true,"description":"A user's Portal Account UID"},"timezone":{"type":"string","description":"The time zone of the user."}}},"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}}}},"paths":{"/v2p2/parents":{"post":{"summary":"Create New Parent","operationId":"createParent","tags":["Parents"],"description":"Creates a new parent record. The Content-Type header must be set to application/json,\nand the request body should contain the parent fields as a JSON payload.\n\nOnly users with the admin role are able to create parent accounts. An email address is required.\nOptionally, child_ids can be provided to link the parent to existing students.\n\nPass options[send_welcome_email]: true to enqueue a welcome email (with password-set link) to the new parent. Defaults to false.\n","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/Parent"},"options":{"type":"object","properties":{"welcome_email":{"type":"string","enum":["enqueued","not_enqueued"]}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}},"422":{"description":"Unprocessable Content","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"allOf":[{"$ref":"#/components/schemas/Parent"},{"description":"Fields for create parent"}]},"options":{"type":"object","description":"Request directives applied during the create operation.","properties":{"send_welcome_email":{"type":"boolean","default":false,"description":"If true, a welcome email is enqueued for the newly created parent."}}}},"required":["parent"]}}}}}}}}
```
## Get a Parent
> Retrieves a single parent record by ID. Returns personal details, contact information, and the IDs of their associated students (children).
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"Parent":{"anyOf":[{"$ref":"#/components/schemas/PersonalInformation"},{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID for a parent in ManageBac."},"salutation":{"type":"string","description":"Parent/guardian’s title.","enum":["Mr.","Ms.","Mrs.","Dr."]},"title":{"type":"string","description":"Parent/guardian’s work position."},"employer":{"type":"string","description":"Parent/guardian’s employer."},"work_email":{"type":"string","description":"Parent/guardian’s work email address (may differ to email field)."},"work_phone":{"type":"string","description":"Parent/guardian’s work number."},"work_address":{"type":"string","description":"First line of parent/guardian’s work address."},"work_address_ii":{"type":"string","description":"Second (optional) line of parent/guardian’s work address."},"work_fax":{"type":"string","description":"Fax number for parent/guardian’s work"},"work_city":{"type":"string","description":"City of parent/guardian’s work address."},"work_state":{"type":"string","description":"State of parent/guardian’s work address."},"work_postal_code":{"type":"string","description":"Postal/zip code of parent/guardian’s work address."},"work_country":{"type":"string","description":"Country of parent/guardian’s address."},"sb_id":{"type":"string","description":"SchoolsBuddy uniq ID"},"oa_id":{"type":"string","description":"OpenApply uniq ID"},"child_ids":{"type":"array","readOnly":true,"items":{"type":"integer"},"description":"Unique ID for offspring/wards of the parent/guardian."}}}]},"PersonalInformation":{"type":"object","description":"Common personal and contact fields shared by Teacher, Student, and Parent schemas. On POST (create), email and last_name are required. On PATCH (update), only include fields you want to change.\n","properties":{"email":{"type":"string","description":"User’s primary email address. Used for login and notifications. Required on create."},"first_name":{"type":"string","description":"User’s first given name."},"middle_name":{"type":"string","description":"User’s additional name."},"password":{"type":"string","description":"Minimum 6-character password. Only used on POST (create) and PATCH (update). Never returned in GET responses. If omitted on create, a random password is generated and the user receives a welcome email.\n"},"last_name":{"type":"string","description":"User’s surname."},"nickname":{"type":"string","description":"User’s handle (may differ to given name)."},"other_name":{"type":"string","description":"User’s additional names or variant in a different language."},"identifier":{"type":"string","description":"School’s own unique ID for user."},"gender":{"type":"string","description":"The user's gender. Accepts \"Male\", \"Female\", or other values depending on school configuration."},"birthday":{"type":"string","description":"User’s dob; yyyy-mm-dd."},"phone_number":{"type":"string","description":"User’s home number."},"mobile_phone_number":{"type":"string","description":"User’s mobile number."},"street_address":{"type":"string","description":"First line of user’s home address."},"street_address_ii":{"type":"string","description":"Second (optional) line of user’s home address."},"city":{"type":"string","description":"City of user’s home address."},"state":{"type":"string","description":"State of user’s home address."},"zipcode":{"type":"string","description":"Postal/zip code of user’s home address."},"country":{"type":"string","description":"Country of user’s home address."},"nationalities":{"type":"array","description":"One or more nationalities of the user.","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"},"description":"Fluent language/s of the user."},"account_uid":{"type":"string","readOnly":true,"description":"A user's Portal Account UID"},"timezone":{"type":"string","description":"The time zone of the user."}}},"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}},"NotFound":{"type":"object","description":"Returned when the requested resource cannot be found by the given ID.","properties":{"error":{"type":"string","description":"Record was not found"}}}}},"paths":{"/v2p2/parents/{id}":{"get":{"summary":"Get a Parent","operationId":"getParentByID","tags":["Parents"],"description":"Retrieves a single parent record by ID. Returns personal details, contact information, and the IDs of their associated students (children).\n","parameters":[{"name":"id","in":"path","description":"The unique numeric identifier of the parent record.","schema":{"type":"integer"},"required":true}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/Parent"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}}}
```
## Update a Parent
> Updates an existing parent record by ID. The \Content-Type\ header must be set to \application/json\,\
> and the request body should contain only the fields you want to update as a JSON payload.\
> \
> Only users with the \admin\ role are able to update parent accounts. Fields not included in the payload are left unchanged.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"Parent":{"anyOf":[{"$ref":"#/components/schemas/PersonalInformation"},{"type":"object","properties":{"id":{"type":"integer","description":"Unique ID for a parent in ManageBac."},"salutation":{"type":"string","description":"Parent/guardian’s title.","enum":["Mr.","Ms.","Mrs.","Dr."]},"title":{"type":"string","description":"Parent/guardian’s work position."},"employer":{"type":"string","description":"Parent/guardian’s employer."},"work_email":{"type":"string","description":"Parent/guardian’s work email address (may differ to email field)."},"work_phone":{"type":"string","description":"Parent/guardian’s work number."},"work_address":{"type":"string","description":"First line of parent/guardian’s work address."},"work_address_ii":{"type":"string","description":"Second (optional) line of parent/guardian’s work address."},"work_fax":{"type":"string","description":"Fax number for parent/guardian’s work"},"work_city":{"type":"string","description":"City of parent/guardian’s work address."},"work_state":{"type":"string","description":"State of parent/guardian’s work address."},"work_postal_code":{"type":"string","description":"Postal/zip code of parent/guardian’s work address."},"work_country":{"type":"string","description":"Country of parent/guardian’s address."},"sb_id":{"type":"string","description":"SchoolsBuddy uniq ID"},"oa_id":{"type":"string","description":"OpenApply uniq ID"},"child_ids":{"type":"array","readOnly":true,"items":{"type":"integer"},"description":"Unique ID for offspring/wards of the parent/guardian."}}}]},"PersonalInformation":{"type":"object","description":"Common personal and contact fields shared by Teacher, Student, and Parent schemas. On POST (create), email and last_name are required. On PATCH (update), only include fields you want to change.\n","properties":{"email":{"type":"string","description":"User’s primary email address. Used for login and notifications. Required on create."},"first_name":{"type":"string","description":"User’s first given name."},"middle_name":{"type":"string","description":"User’s additional name."},"password":{"type":"string","description":"Minimum 6-character password. Only used on POST (create) and PATCH (update). Never returned in GET responses. If omitted on create, a random password is generated and the user receives a welcome email.\n"},"last_name":{"type":"string","description":"User’s surname."},"nickname":{"type":"string","description":"User’s handle (may differ to given name)."},"other_name":{"type":"string","description":"User’s additional names or variant in a different language."},"identifier":{"type":"string","description":"School’s own unique ID for user."},"gender":{"type":"string","description":"The user's gender. Accepts \"Male\", \"Female\", or other values depending on school configuration."},"birthday":{"type":"string","description":"User’s dob; yyyy-mm-dd."},"phone_number":{"type":"string","description":"User’s home number."},"mobile_phone_number":{"type":"string","description":"User’s mobile number."},"street_address":{"type":"string","description":"First line of user’s home address."},"street_address_ii":{"type":"string","description":"Second (optional) line of user’s home address."},"city":{"type":"string","description":"City of user’s home address."},"state":{"type":"string","description":"State of user’s home address."},"zipcode":{"type":"string","description":"Postal/zip code of user’s home address."},"country":{"type":"string","description":"Country of user’s home address."},"nationalities":{"type":"array","description":"One or more nationalities of the user.","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"},"description":"Fluent language/s of the user."},"account_uid":{"type":"string","readOnly":true,"description":"A user's Portal Account UID"},"timezone":{"type":"string","description":"The time zone of the user."}}},"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}},"NotFound":{"type":"object","description":"Returned when the requested resource cannot be found by the given ID.","properties":{"error":{"type":"string","description":"Record was not found"}}}}},"paths":{"/v2p2/parents/{id}":{"patch":{"summary":"Update a Parent","operationId":"updateParent","tags":["Parents"],"description":"Updates an existing parent record by ID. The Content-Type header must be set to application/json,\nand the request body should contain only the fields you want to update as a JSON payload.\n\nOnly users with the admin role are able to update parent accounts. Fields not included in the payload are left unchanged.\n","parameters":[{"name":"id","in":"path","description":"The unique numeric identifier of the parent record.","schema":{"type":"integer"},"required":true}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/Parent"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Content","content":{"application/json":{}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"allOf":[{"$ref":"#/components/schemas/Parent"},{"description":"Fields for update parent"}]}},"required":["parent"]}}}}}}}}
```
## Archive a Parent
> Archives a parent record by ID. Archiving effectively removes the parent from any groups they are members of and hides them from active user lists.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}}},"paths":{"/v2p2/parents/{id}/archive":{"put":{"summary":"Archive a Parent","operationId":"archiveParent","tags":["Parents"],"description":"Archives a parent record by ID. Archiving effectively removes the parent from any groups they are members of and hides them from active user lists.\n","parameters":[{"name":"id","in":"path","description":"The unique numeric identifier of the parent record to archive.","schema":{"type":"integer"},"required":true}],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"}}}}}}
```
## Unarchive a Parent
> Reverses the archive operation on a parent record by ID. This restores the parent to active status and re-establishes their group memberships.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}}},"paths":{"/v2p2/parents/{id}/unarchive":{"put":{"summary":"Unarchive a Parent","operationId":"unarchiveParent","tags":["Parents"],"description":"Reverses the archive operation on a parent record by ID. This restores the parent to active status and re-establishes their group memberships.\n","parameters":[{"name":"id","in":"path","description":"The unique numeric identifier of the parent record to unarchive.","schema":{"type":"integer"},"required":true}],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"}}}}}}
```
## Send Welcome Email to a Parent
> This endpoint enqueues a welcome email (with password-set link) for an existing parent.\
> No request body is required. There is no restriction based on whether the parent has\
> previously logged in. The endpoint is not idempotent — calling it twice enqueues two emails.
```json
{"openapi":"3.0.3","info":{"title":"API V2P2","version":"v2p2"},"tags":[{"name":"Parents","description":"Parents are users who are adults connected to students"}],"servers":[{"url":"https://api.managebac.com","description":"CA ManageBac API server."},{"url":"https://api.managebac.cn","description":"CN ManageBac API server."},{"url":"https://api.us.managebac.com","description":"US1 ManageBac API server."},{"url":"https://api.managebac.us","description":"US2 ManageBac API server."},{"url":"https://api.managebactest.com","description":"UAT ManageBac API server."},{"url":"https://{Host}","variables":{"Host":{"default":"api.devel.managebac.com","enum":["api.devel.managebac.com","api-faria.devel.managebac.com","api.managebac.dev"]}}}],"security":[{"bearerAuth":[]},{"authTokenQuery":[]},{"authTokenHeader":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as `Bearer `."},"authTokenQuery":{"type":"apiKey","name":"auth_token","in":"query","description":"Your V2 API authentication token may be passed in the parameters. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."},"authTokenHeader":{"type":"apiKey","name":"auth-token","in":"header","description":"Your V2 API authentication token may be passed in the header. To protect your key, use [environment variables](https://cloud.google.com/docs/authentication/api-keys#securing_an_api_key)."}},"schemas":{"AccessDeniedError":{"type":"object","description":"Returned when the API token is missing, invalid, or has been disabled.","properties":{"error":{"type":"string","description":"Unauthorized to perform an action"}}},"NotFound":{"type":"object","description":"Returned when the requested resource cannot be found by the given ID.","properties":{"error":{"type":"string","description":"Record was not found"}}}}},"paths":{"/v2p2/parents/{id}/welcome_email":{"post":{"summary":"Send Welcome Email to a Parent","operationId":"sendParentWelcomeEmail","tags":["Parents"],"description":"This endpoint enqueues a welcome email (with password-set link) for an existing parent.\nNo request body is required. There is no restriction based on whether the parent has\npreviously logged in. The endpoint is not idempotent — calling it twice enqueues two emails.\n","parameters":[{"name":"id","in":"path","description":"Unique identifier for a parent.","schema":{"type":"integer"},"required":true}],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}}}
```