# Builderly API reference

Base URL: http://www.startup-fair.com
Generated from the running server on 2026-11-19T14:01:21.066Z. Every mounted route is listed with the access it needs, the parameters its handler reads and the data models it uses.

## Authentication

Send `Authorization: Bearer <token>` where a route needs a token. Add `?ionic=true` to get JSON from routes that also render pages.

- **Admin token** (`admin`): Bearer token of a site admin (Authorization: Bearer <token>).
- **User token** (`user`): Bearer token of a signed-in user of the site.
- **Optional user** (`optional-user`): Works without a token; a user token personalises the answer.
- **User with access** (`user-priv`): A signed-in user whose plan grants access to the item.
- **Page access** (`page-priv`): Pages limited to some users check the token when one is sent.
- **Webhook signature** (`webhook`): Called by a provider; verified by its signature.
- **reCAPTCHA** (`recaptcha`): Needs a reCAPTCHA token from the site form.
- **System** (`system`): Internal - called by the platform itself.

### For AI assistants: getting a token

Public endpoints (Access: Public) need no token. Everything else - changing the site, or reading its orders, bookings, customers and other private data - needs the site owner's API token.

You cannot create a token yourself, and you must not ask for the owner's password. Ask the user for a token instead - you can send them this message as it is:

> To work with your site through its API, I need an API token from you:
> 1. Sign in to your Builderly admin: https://admin.max-media.io
> 2. Open Developers > API reference (or go straight to https://admin.max-media.io/tabs/site-builder/api-docs).
> 3. Press "Generate token", copy the token and paste it here.
> The token acts as you, so only share it in this chat. You can cancel it at any time by signing out of all devices.

Then send it with every request as `Authorization: Bearer <token>`, and add `?ionic=true` to get JSON. Calls go to the site's own address (its domain), not to the reference's.

The token acts as the user: say what you will change and wait for their yes before any request that creates, changes or deletes something, never repeat the token back, and never put it in a link or a file you share.

## Status codes

| Code | Name | Meaning |
| --- | --- | --- |
| 200 | OK | It worked. The answer is the object or list asked for. |
| 201 | Created | The object was created. Some endpoints send it back; others send an empty body. |
| 202 | Accepted | The work was started and finishes in the background - for example a video being processed ({ "status": "processing" }). Check back on the object. |
| 204 | No Content | It worked, and there is nothing to send back - for example after removing a staff member. |
| 301 | Moved Permanently | The address changed; follow the Location header. |
| 400 | Bad Request | The request was refused as sent: a required field is missing, a value has the wrong type or fails validation. The body says what - often as plain text. |
| 401 | Unauthorized | No token, or one that is invalid or signed out. Without ?ionic=true, some endpoints answer this with the HTML login page instead of JSON. |
| 402 | Payment Required | The content needs a subscription: the user has no price plan that unlocks it. |
| 403 | Forbidden | The token is valid but may not do this - the record belongs to someone else, or the user is not an admin. AI builder endpoints also answer 403 when the account is out of credits. |
| 404 | Not Found | No object with that ID or URL slug, or no such endpoint. |
| 409 | Conflict | It clashes with the current state: the item is already being processed, a version is already applied, or an AI plan or preview is no longer available. |
| 410 | Gone | It existed but is no longer there - for example a comment already deleted on the social network. |
| 412 | Precondition Failed | A rule the request must meet is not met - for example push notifications of the same type at least 48 hours apart. |
| 418 | I'm a teapot | An account confirmation or password reset link was used with an email that does not match it. |
| 421 | Misdirected Request | The domain is not a Builderly site. Call the site's own address. |
| 422 | Unprocessable Content | The request was understood but could not be done - for example the AI could not read the website it was asked to clone. The message says what to try instead. |
| 429 | Too Many Requests | Slow down: the site's request limit was reached, an AI chat already has a request running, or the hourly limit of AI search answers is used up. Wait and retry. |
| 500 | Internal Server Error | Something failed on the server. Retrying later may work; if it keeps failing, the request may be one the endpoint does not handle. |
| 502 | Bad Gateway | A service the request depends on failed - for example the address a redirect forwards to. |
| 503 | Service Unavailable | Used by the lead form when an order is below its minimum value, not only for outages: read the message. |

Errors do not share one shape: depending on the endpoint the body is plain text, { "error": "..." }, { "message": "..." } or empty. Rely on the status code, and show the body to the user as the reason.

## Endpoints

### Moderation

Moderation is the owner reviewing what other people put on a marketplace or social site: their products, services, programs and mini apps waiting for approval, and their requests for a professional account. An approval goes live and tells its owner.

##### Update the admin professional account
`PATCH /admin-professional-accounts/:account`
Approves or rejects a professional account request (approved). Approving it also approves every item of that account still waiting for review. Answers the account, or 404.
- Access: Admin token
- Path:
  - `account` (string): The admin professional account's account.
- Body:
  - `approved` (boolean): The account was approved as professional.
- Returns: the ProfessionalAccount object.
- Status codes: 200, 400, 401, 404, 500
- Models: ProfessionalAccount, Model

##### List all admin professional accounts
`GET /admin-professional-accounts/:skip`
Professional account requests, a page at a time.
- Access: Admin token
- Path:
  - `skip` (string): How many results to skip - for paging.
- Returns: a list of ProfessionalAccount objects.
- Status codes: 200, 401, 500
- Models: ProfessionalAccount

##### Retrieve the mini apps review
`GET /mini-apps-review`
Mini apps waiting for review.
- Access: Admin token
- Status codes: 200, 401, 500
- Models: MiniApp

##### Update a mini apps review
`PATCH /mini-apps-review/:id`
Approves or rejects a mini app (approved). Answers the mini app, or 404.
- Access: Admin token
- Path:
  - `id` (string): The ID of the mini apps review.
- Body:
  - `approved` (string): The mini apps review's approved.
  - `reviewed` (string): The mini apps review's reviewed.
- Status codes: 200, 400, 401, 404, 500
- Models: MiniApp

##### Update a products review
`PATCH /products-review/:id`
Approves or rejects a marketplace product (approved) and tells its owner. An approved product goes live for a month and its owner gets an email and a notification. Answers the product, or 404.
- Access: Admin token
- Path:
  - `id` (string): The ID of the products review.
- Body:
  - `approved` (string): The products review's approved.
- Status codes: 200, 400, 401, 404, 500
- Models: Product, UserEngagementNotification

##### List all products reviews
`GET /products-review/:skip`
Marketplace products waiting for review, a page at a time.
- Access: Admin token
- Path:
  - `skip` (string): How many results to skip - for paging.
- Status codes: 200, 401, 500
- Models: Product

##### Update a programs review
`PATCH /programs-review/:id`
Approves or rejects a marketplace program (approved) and tells its owner. An approved program goes live for a month and its owner gets an email and a notification. Answers the program, or 404.
- Access: Admin token
- Path:
  - `id` (string): The ID of the programs review.
- Body:
  - `approved` (string): The programs review's approved.
- Status codes: 200, 400, 401, 404, 500
- Models: Program, UserEngagementNotification

##### List all programs reviews
`GET /programs-review/:skip`
Marketplace programs waiting for review, a page at a time.
- Access: Admin token
- Path:
  - `skip` (string): How many results to skip - for paging.
- Status codes: 200, 401, 500
- Models: Program

##### Update a services review
`PATCH /services-review/:id`
Approves or rejects a marketplace service (approved) and tells its owner. An approved service goes live for a month and its owner gets an email and a notification. Answers the service, or 404.
- Access: Admin token
- Path:
  - `id` (string): The ID of the services review.
- Body:
  - `approved` (string): The services review's approved.
- Status codes: 200, 400, 401, 404, 500
- Models: Service, UserEngagementNotification

##### List all services reviews
`GET /services-review/:skip`
Marketplace services waiting for review, a page at a time.
- Access: Admin token
- Path:
  - `skip` (string): How many results to skip - for paging.
- Status codes: 200, 401, 500
- Models: Service

## Objects

### MiniApp

- `title`: String, required - The mini app's name.
- `header`: String, required - Short heading shown in the app store.
- `description`: String - About the mini app.
- `referer`: String, required - The address the mini app is served from.
- `requiresLogin`: Boolean, default true - Only signed-in users can open it.
- `icon`: ObjectId, → Media - Media.id.
- `previews`: Object[] - Screenshots shown in the store.
  - `media`: ObjectId, → Media
  - `_id`: ObjectId
- `owner_id`: ObjectId, required, → User - User.id.
- `reviewed`: Boolean, default false - A moderator reviewed it.
- `approved`: Boolean, default false - Approved to be listed.
- `total_opened`: Number, default 0 - How many times it was opened.
- `opened_by`: ObjectId[], → User - User ids.
- `minimum_age`: Number - Youngest age allowed to use it.
- `language`: String[] - Languages it supports.
- `collection_id`: ObjectId, → Collection - Collection.id.
- `total_views`: Number, default 0 - How many times its store page was viewed.
- `views`: ObjectId[], → User - User ids.
- `privacy_policy`: String, required - Link to its privacy policy.
- `data_collection.contact_info`: String[]
- `data_collection.health_info`: String[]
- `data_collection.payment_info`: String[]
- `data_collection.location_info`: String[]
- `data_collection.other_info`: String[]
- `data_collection.user_info`: String[]
- `data_collection.identifiers_info`: String[]
- `data_collection.usage_data`: String[]
- `data_collection.diagnostics_data`: String[]
- `support_url`: String - Link to support.
- `marketing_url`: String - Link to its marketing site.
- `copyright`: String - Copyright line.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### Model

- `name`: String, required
- `make`: ObjectId, → Make
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### Product

An item the store sells, with its price, images, options and delivery details.

- `name`: String, required - Name of product.
- `url`: String, required - Generated from name, no need to set it manually.
- `static_url`: String - A fixed address kept when the url changes, so old links keep working.
- `ribbon`: String - Short label shown on the product's card, e.g. "New" or "-20%".
- `striked`: String - The old price, shown crossed out next to price: for a sale ("was 12, now 9") set price to 9 and striked to "12". Empty for no sale.
- `price`: Number, required - Price of the product in the site's currency.
- `description`: String - Description of product in html format.
- `product_informations`: Object[] - Extra details listed on the product page, each { name, description } ("Material": "Soy wax").
  - `name`: String, required
  - `description`: String, required
  - `_id`: ObjectId
- `product_options`: Object[] - The choices a buyer makes (Size, Colour): each { name, options: [{ option }] }. An option's text may carry a price change in brackets, "Large (+5)", added to price. Changing the options rebuilds the product's stock lines.
  - `name`: String, required
  - `options`: Object[]
    - `option`: String, required
    - `match_to_collection`: ObjectId, → Collection
    - `quantity`: Number
    - `badge`: String
    - `option_specific_media`: ObjectId, → Media
    - `_id`: ObjectId
  - `informations`: Object[]
    - `name`: String
    - `description`: String
    - `_id`: ObjectId
  - `_id`: ObjectId
- `published`: Boolean, default true - Shown on the site. False hides it from the store and lists without deleting it.
- `available_for_purchase`: Boolean, default true - The whole product can be bought; false stops every option of it. One option sold out ("the white mug ran out") is that option's stock line: quantity 0, tracked.
- `medias`: Object[] - Array of {media}.
  - `media`: ObjectId, → Media
  - `gcs_url`: String
  - `gcs_480_30_url`: String
  - `gcs_720_30_url`: String
  - `gcs_1080_30_url`: String
  - `duration`: Number
  - `vimeo_uri`: String
  - `vimeo_picture`: String
  - `vimeo_url`: String
  - `youtube_url`: String
  - `youtube_picture`: String
  - `thumbnail`: String
  - `_id`: ObjectId
- `collection_id`: ObjectId, → Collection - Collection.id.
- `grouping`: Object[] - The grouping/ filters it appears under inside its category: each { collection_id }.
  - `collection_id`: ObjectId, → Collection
  - `_id`: ObjectId
- `order`: Number - Manual store order: products with one are listed first, higher first, when no sortBy is asked; unset for the rest. Set it with PATCH /products-reorder {items: [{_id, order}]}; PATCH /products/:id ignores it.
- `owner_id`: ObjectId, required, → User - User.id.
- `connected_account_owner_id`: ObjectId, → User - User.id.
- `qty`: Number, default 1 - Not the stock: nothing reads it as stock. Stock is kept per option in stock lines (Inventory): read GET /inventory/:product_id/:option, set it with PATCH /inventory/:id {quantity}.
- `origin_address`: String - Name of the address, taken from OriginAdress model, used for filtering.
- `selected`: Boolean, default false - Featured: the home page's highlighted products block shows these first.
- `custom_1`: String - Custom defined field 1.
- `custom_2`: String - Custom defined field 2.
- `custom_3`: String - Custom defined field 3.
- `about_page`: ObjectId, → AboutPage - Reference to AboutPage model, shown in product page.
- `is_digital`: Boolean, default false - Delivered as a download, not shipped.
- `digital_contents`: Object[] - The files a buyer gets.
  - `content`: ObjectId, → DigitalContent
  - `option`: String
  - `_id`: ObjectId
- `suitability_price_plans`: ObjectId[], → PricePlan - PricePlan ids: a signed-in user with one of them sees the product as suitable (isSuitable).
- `isSuitable`: Boolean - Set per request, not stored: whether the signed-in user's price plans match the product's suitability plans.
- `brand`: String - Name of the product brand.
- `brand_logo`: ObjectId, → Media - Logo of the brand, reference to Media model.
- `weight`: Number, default 0 - Weight of the product in kg, for delivery.
- `height`: Number, default 0 - Height of the product in cm, for delivery.
- `length`: Number, default 0 - Length of the product in cm, for delivery.
- `width`: Number, default 0 - Width of the product in cm, for delivery.
- `delivery_type`: String, default "parcel" - Used for delivery, default is parcel, allowed values are books, bulk, letter, parcel or parcel_letter.
- `reference_id`: String - Id of the record it was made from (an import or a clone).
- `secondary_cta.show`: Boolean, default false
- `secondary_cta.title`: String
- `secondary_cta.webUrl`: String
- `secondary_cta.appUrl`: String
- `wildcard_url`: Mixed - The wildcard route the product answers on, when it has one.
- `sku`: Mixed - Stock keeping unit code, when the product has one.
- `reviewed`: Boolean - A moderator reviewed it (marketplace).
- `approved`: Boolean - Approved to be listed (marketplace).
- `expired`: Boolean, default false - Past expires_on and no longer listed.
- `expires_on`: Date - When the listing expires.
- `expire_reminder_sent`: Boolean, default false - The owner was reminded it expires.
- `likes`: ObjectId[], → User - User ids.
- `views`: ObjectId[], → User - User ids.
- `total_views`: Number, default 0 - How many times it was opened.
- `saves`: ObjectId[], → User - User ids.
- `times_showed`: Number, default 0 - How many times it was shown in a list.
- `requiresLogin`: Boolean, default false - Only signed-in users can see it.
- `requiresSubscription`: Boolean, default false - Only subscribers can see it.
- `price_plan_ids`: String[] - Reference to PricePlan ids.
- `linked_products`: Object[] - List of products that are shown for quick add to cart in the product page.
  - `product`: ObjectId, → Product
  - `option`: String
  - `_id`: ObjectId
- `attached_priceplans.name`: String
- `attached_priceplans.priceplans`: ObjectId[], → PricePlan
- `about_section`: ObjectId, → AboutPage - Reference to AboutPage model, shown below the add to cart button.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### ProfessionalAccount

- `user`: ObjectId, required, → User - Id of user, who has created the account.
- `show.services`: Boolean, default true
- `show.staff_members`: Boolean, default true
- `show.blogposts`: Boolean, default true
- `show.programs`: Boolean, default true
- `show.products`: Boolean, default true
- `show.events`: Boolean, default true
- `show.price_plans`: Boolean, default true
- `show.posts`: Boolean, default true
- `reviewed`: Boolean, default false - A moderator reviewed the request.
- `approved`: Boolean, default false - The account was approved as professional.
- `cover`: ObjectId, → Media - Media.id.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### Program

An online course: weeks of days, each day a list of steps.

- `title`: String - Name of the program, required.
- `url`: String, required - Generated from title, no need to set it manually.
- `static_url`: String - A fixed address kept when the url changes.
- `header`: String - Short tagline or subtitle shown in listings, optional.
- `body`: String - Full program description in HTML format, optional.
- `medias`: Object[] - The program's pictures.
  - `media`: ObjectId, → Media
  - `gcs_url`: String
  - `gcs_480_30_url`: String
  - `gcs_720_30_url`: String
  - `gcs_1080_30_url`: String
  - `duration`: Number
  - `vimeo_uri`: String
  - `vimeo_picture`: String
  - `vimeo_url`: String
  - `youtube_url`: String
  - `youtube_picture`: String
  - `thumbnail`: String
  - `_id`: ObjectId
- `video`: ObjectId, → Video - Video.id.
- `about_page`: ObjectId, → AboutPage - AboutPage.id.
- `weeks`: Object[] - A list of week objects, required.
  - `isCompleted`: Mixed
  - `progress`: Mixed
  - `title`: String
  - `days`: Object[]
    - `isCompleted`: Mixed
    - `progress`: Mixed
    - `title`: String
    - `steps`: Object[]
      - `title`: String, required
      - `body`: String, required
      - `video`: ObjectId, → Video
      - `medias`: Object[]
      - `about_page`: ObjectId, → AboutPage
      - `timer`: Number, default 0
      - `_id`: ObjectId
    - `_id`: ObjectId
  - `_id`: ObjectId
- `suitability_price_plans`: ObjectId[], → PricePlan - A list of PricePlan ids, marks program as suitable for users with those plans.
- `isSuitable`: Boolean - Set per request, not stored: whether the signed-in user's price plans match the program's suitability plans.
- `popup.title`: String
- `popup.points`: String[]
- `price`: Number, default 0 - Price in the user's currency, default 0.
- `collection_id`: ObjectId, → Collection - Reference to a Collection with name starting with 'program-category/', required.
- `topics`: Object[] - Topics it covers.
  - `collection_id`: ObjectId, → Collection
  - `_id`: ObjectId
- `owner_id`: ObjectId, required, → User - User.id.
- `connected_account_owner_id`: ObjectId, → User - User.id.
- `ribbon`: String - Short badge text shown on the card (e.g. "New", "Best seller"), optional.
- `striked`: String - Original price shown as strikethrough next to the real price, optional.
- `isConsistent`: Boolean, default false - Every week has the same structure.
- `isAcademic`: Boolean, default true - Free-order course, not weeks and days: progress is not tied to a week and day.
- `wildcard_url`: Mixed - The wildcard route it answers on, when it has one.
- `reviewed`: Boolean - A moderator reviewed it.
- `approved`: Boolean - Approved to be listed.
- `likes`: ObjectId[], → User - User ids.
- `views`: ObjectId[], → User - User ids.
- `total_views`: Number, default 0 - How many times it was opened.
- `saves`: ObjectId[], → User - User ids.
- `requiresLogin`: Boolean, default false - Only signed-in users can see it.
- `requiresSubscription`: Boolean, default false - Only subscribers can see it.
- `price_plan_ids`: String[] - A list of price plan id strings that grant access to this program.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### Service

A bookable service: its duration, price, the staff who perform it and when it can be booked.

- `title`: String, required - Title of service.
- `url`: String, required - Generated from title, no need to set it manually.
- `static_url`: String - A fixed address kept when the url changes, so old links keep working.
- `header`: String - Short header of service.
- `description`: String - Body text of service.
- `bookable`: Boolean, default true - True if not set.
- `expirable`: Boolean, default false - The listing expires.
- `confirm_bookings`: Boolean, default false - Bookings wait for the business to confirm them.
- `show_notes`: Boolean, default false - Customers can write a note when booking.
- `minutes_delete_bookings`: Number - Number of minutes before the booking expires before being confirmed and is set 'expirable:true'.
- `medias`: Object[] - Attached media objects with ids.
  - `media`: ObjectId, → Media
  - `gcs_url`: String
  - `gcs_480_30_url`: String
  - `gcs_720_30_url`: String
  - `gcs_1080_30_url`: String
  - `duration`: Number
  - `vimeo_uri`: String
  - `vimeo_picture`: String
  - `vimeo_url`: String
  - `youtube_url`: String
  - `youtube_picture`: String
  - `thumbnail`: String
  - `_id`: ObjectId
- `collection_id`: ObjectId, → Collection - Collection, to which the blog post belongs.
- `price`: Number - The price of the service in the globally set currency.
- `online_payment`: Boolean, default false - Bookings are paid online.
- `book_by_date`: Boolean, default false - Whole days are booked, not time slots.
- `book_date_range`: Boolean, default false - A range of days is booked (a stay).
- `start_date`: Date - Date.
- `end_date`: Date - Date.
- `day_offset`: Number, default 0 - How many days ahead of today booking opens; 0 allows today.
- `is_recurring`: Boolean, default false - The service repeats on a schedule.
- `max_participants`: Number, required - How many people can book one slot.
- `session_duration`: Number, required - Length of a slot in minutes.
- `time_between_sessions`: Number, default 0 - Break added after each slot, in minutes.
- `discount`: Object[] - Discounts by number of sessions booked.
  - `days`: Number
  - `per_total_price`: Number
  - `fixed_price`: Number
  - `per_day`: Number
  - `_id`: ObjectId
- `monday.active`: Boolean, default false
- `monday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `tuesday.active`: Boolean, default false
- `tuesday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `wednesday.active`: Boolean, default false
- `wednesday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `thursday.active`: Boolean, default false
- `thursday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `friday.active`: Boolean, default false
- `friday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `saturday.active`: Boolean, default false
- `saturday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `sunday.active`: Boolean, default false
- `sunday.hours`: Object[]
  - `start`: String
  - `end`: String
  - `_id`: ObjectId
- `address`: String - Where is the service performed.
- `staff_member`: ObjectId[], → User - [User.id].
- `owner_id`: ObjectId, → User - User.id.
- `connected_account_owner_id`: ObjectId, → User - User.id.
- `timezone`: Number, default false - Time zone offset the slots are in, in hours.
- `choose_timezone`: Boolean - Customers pick the time zone slots are shown in.
- `origin_address`: String - OriginAddress.id where the service is given.
- `selected`: Boolean, default false - False if not set.
- `custom_1`: String - Custom defined field 1.
- `custom_2`: String - Custom defined field 2.
- `custom_3`: String - Custom defined field 3.
- `about_page`: ObjectId, → AboutPage - AboutPage.id.
- `show_only_about_page`: Boolean, default false - The service page shows only its attached page.
- `suitability_price_plans`: ObjectId[], → PricePlan - PricePlan ids.
- `isSuitable`: Boolean - Set per request, not stored: whether the signed-in user's price plans match the service's suitability plans.
- `booking_only`: Boolean - If the booking page should not show a header and footer.
- `dates_disabled`: String[] - Closed days: dates on which the service cannot be booked (a holiday, a day off). Add a date here to close it.
- `dates_booked`: String[] - Days that are fully booked.
- `receipt_about_page`: ObjectId, → AboutPage - AboutPage.id.
- `wildcard_url`: Mixed - The wildcard route it answers on, when it has one.
- `locked_hours`: Date[] - Hours that cannot be booked.
- `reviewed`: Boolean - A moderator reviewed it (marketplace).
- `approved`: Boolean - Approved to be listed (marketplace).
- `likes`: ObjectId[], → User - User ids.
- `views`: ObjectId[], → User - User ids.
- `total_views`: Number, default 0 - How many times it was opened.
- `saves`: ObjectId[], → User - User ids.
- `times_showed`: Number, default 0 - How many times it was shown in a list.
- `analytics_locales.google_event_custom_title`: String, default "schedule"
- `analytics_locales.facebook_event_custom_title`: String, default "Schedule"
- `analytics_locales.tiktok_event_custom_title`: String
- `analytics_locales.linkedin_event_custom_title`: String
- `analytics_locales.chatgpt_event_custom_title`: String
- `email_text`: String - The text the client will receive inside the email.
- `calendar_description`: String - The text the client will see when adding the appointment inside their calendar.
- `requiresLogin`: Boolean, default false - Only signed-in users can see it.
- `requiresSubscription`: Boolean, default false - Only subscribers of price_plan_ids can see it.
- `price_plan_ids`: String[] - Price plans whose subscribers can see it, with requiresSubscription.
- `calendar_filter`: Object[] - Filters shown on the booking calendar.
  - `collection_id`: ObjectId, → Collection
  - `_id`: ObjectId
- `locked_ranges`: Object[] - Date and time ranges that cannot be booked.
  - `start`: Date
  - `end`: Date
  - `_id`: ObjectId
- `connected_services`: ObjectId[], → Service - Service ids.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date

### UserEngagementNotification

- `type`: String - Liked_post, commented, liked_comment, replied_to, mentioned, sent_message, search, followed, profile_visit, system, group_request_received, group_request_accepted, activity_boost.
- `title`: String, required - The notification's heading.
- `body`: String - The notification's text.
- `owner_id`: ObjectId, → User - User.id.
- `from`: ObjectId, → User - User.id.
- `post`: ObjectId, → Post - Post.id.
- `group`: ObjectId, → Group - Group.id.
- `sendToAll`: Boolean, default false - Goes to every user.
- `comment`: ObjectId, → Comment - Comment.id.
- `is_received`: Boolean, default false - Delivered to the user.
- `is_seen`: Boolean, default false - The user saw it.
- `url`: String - Where tapping it leads.
- `image`: String - Picture shown with it.
- `service`: ObjectId, → Service - Service.id.
- `product`: ObjectId, → Product - Product.id.
- `blogpost`: ObjectId, → BlogPost - BlogPost.id.
- `program`: ObjectId, → Program - Program.id.
- `booking`: ObjectId, → Booking - Booking.id.
- `_id`: ObjectId
- `updatedAt`: Date
- `createdAt`: Date
