Parents
Parents are users who are adults connected to students
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.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
Return only records with the given IDs.
Return only archived (1) or only active (0) parents. If value is not specified, all parents are returned.
An ISO 8601 timestamp to filter parents modified on or after this date.
An integer defining which page to display. Defaults to 1.
An integer defining the number of records to display per page. Defaults to 100.
An ISO 8601 timestamp to filter parents deleted on or after this date. Returns soft-deleted records.
A search string matched against parent name, email, and other fields.
Success
Unauthorized
GET /v2p2/parents HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"parents": [
{
"id": 2020,
"email": "308-jmoore@kwilith.com",
"first_name": "Kevin",
"last_name": "Dixon",
"identifier": "AA1001",
"archived": false,
"ui_language": "en",
"gender": "Male",
"timezone": "Europe/Kyiv",
"last_accessed_at": "2021-02-25T08:13:03.000-08:00",
"child_ids": [],
"children": [],
"street_address": "714 Hoard Terrace",
"city": "Menlo Park",
"state": "33117",
"zipcode": "65092",
"country": "PG",
"nationalities": [],
"languages": [],
"role": "Parent"
}
],
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 1,
"per_page": 100
}
}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.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
Fields for create parent
Success
Unauthorized
Unprocessable Content
POST /v2p2/parents HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 562
{
"parent": {
"email": "richard.chandler@eduvo.com",
"first_name": "Richard",
"middle_name": "David",
"password": "qwerty9876",
"last_name": "Chandler",
"nickname": "Ricky",
"other_name": "",
"identifier": "AA1001",
"gender": "Male",
"birthday": "1972-10-24",
"phone_number": "977 840-2231",
"mobile_phone_number": "977 840-2231",
"street_address": "301 Massachusetts Ave",
"street_address_ii": "",
"city": "Lunenburg",
"state": "Virginia",
"zipcode": "1462",
"country": "United States",
"nationalities": [
"US",
"GB"
],
"languages": [
"ENG"
],
"timezone": "Europe/Kyiv"
},
"options": {
"send_welcome_email": false
}
}{
"parent": {
"id": 2033,
"title": "MD",
"employer": "FEG",
"salutation": "Mr.",
"email": "parent@gmail.com",
"first_name": "Stepan",
"last_name": "Bandera",
"archived": false,
"ui_language": "en",
"child_ids": [],
"children": [],
"nationalities": [],
"languages": []
},
"options": {
"welcome_email": "enqueued"
}
}Retrieves a single parent record by ID. Returns personal details, contact information, and the IDs of their associated students (children).
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
The unique numeric identifier of the parent record.
Success
Unauthorized
Not Found
GET /v2p2/parents/{id} HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"parent": {
"id": 2029,
"email": "317-vward@zoomzone.com",
"first_name": "Justin",
"last_name": "Henderson",
"identifier": "AA1001",
"archived": false,
"ui_language": "en",
"gender": "Male",
"timezone": "America/Lima",
"last_accessed_at": "2021-02-25T08:13:03.000-08:00",
"child_ids": [],
"children": [],
"street_address": "561 Center Avenue",
"city": "Solvang",
"state": "46590-9842",
"zipcode": "81834-7928",
"country": "99",
"nationalities": [],
"languages": [],
"role": "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.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
The unique numeric identifier of the parent record.
Fields for update parent
Success
Unauthorized
Not Found
Unprocessable Content
PATCH /v2p2/parents/{id} HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 523
{
"parent": {
"email": "richard.chandler@eduvo.com",
"first_name": "Richard",
"middle_name": "David",
"password": "qwerty9876",
"last_name": "Chandler",
"nickname": "Ricky",
"other_name": "",
"identifier": "AA1001",
"gender": "Male",
"birthday": "1972-10-24",
"phone_number": "977 840-2231",
"mobile_phone_number": "977 840-2231",
"street_address": "301 Massachusetts Ave",
"street_address_ii": "",
"city": "Lunenburg",
"state": "Virginia",
"zipcode": "1462",
"country": "United States",
"nationalities": [
"US",
"GB"
],
"languages": [
"ENG"
],
"timezone": "Europe/Kyiv"
}
}{
"parent": {
"id": 2036,
"email": "s.banderad@eduvo.com",
"first_name": "Stepan",
"last_name": "Bandera",
"archived": false,
"ui_language": "en",
"gender": "Male",
"timezone": "America/Indiana/Knox",
"last_accessed_at": "2021-02-25T08:13:03.000-08:00",
"child_ids": [],
"children": [],
"street_address": "49702 Melrose Junction",
"city": "El Cajon",
"state": "59637",
"zipcode": "64840-0647",
"country": "BA",
"nationalities": [],
"languages": []
}
}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.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
The unique numeric identifier of the parent record to archive.
Success
Unauthorized
Not Found
PUT /v2p2/parents/{id}/archive HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"status": "ok"
}Reverses the archive operation on a parent record by ID. This restores the parent to active status and re-establishes their group memberships.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
The unique numeric identifier of the parent record to unarchive.
Success
Unauthorized
Not Found
PUT /v2p2/parents/{id}/unarchive HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"status": "ok"
}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.
OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.
Unique identifier for a parent.
No Content
No content
Unauthorized
Not Found
POST /v2p2/parents/{id}/welcome_email HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Last updated