Custom portal pages
Authoring entry point for standalone HTML and JavaScript portal pages through MCP.
Customer portal documentation now has a dedicated section. This page remains available for existing links and MCP authoring instructions.
Authoring checklist
- Read
get_portal_configurationand inspect existing pages withlist_portal_pagesandget_portal_page. The portal must be enabled. - Upload supported files with
upload_portal_asset. Reference returned literal relative paths in HTML and include all used IDs insave_portal_page.assetIds. MCP does not infer asset references from HTML. - Use
save_portal_pageto save a complete HTML draft at an exact path. The published version stays live. Keep CSS and JavaScript inline. - Use
preview_portal_pageto inspect the saved draft. Its private bearer link lasts 30 minutes; a new preview replaces the previous link. - Use
publish_portal_pageto make the saved draft and asset manifest public together. Publishing, unpublishing and deleting revoke previews.
Built-in home, article and category paths take precedence when Help center is
on. Disable Help center to use custom pages at those paths; the master portal
switch still needs to be on. HTML is limited to 512 KiB and assets to 2 MiB each.
Custom pages run in an opaque-origin sandbox without cookies or local storage;
public API fetches must use credentials: "omit". Keep secrets out of public HTML.
For complete guidance, read these pages through read_octocom_docs using the
path shown below:
| Guide | Documentation path |
|---|---|
| Enablement and overview | customer-portal |
| Help center and public article APIs | customer-portal/help-center |
| Drafts, publication, paths and sandbox | customer-portal/custom-pages |
| Uploads, references and deletion | customer-portal/assets |
| DNS setup and connection checks | customer-portal/custom-domains |
| MCP tool reference and examples | customer-portal/mcp |