> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # Add a custom knowledge page > Adds a page you author yourself to the hub and indexes it into the hub's knowledge store before answering — no polling. The page is stored with `origin` `user`, which means the hub's rebuilds never overwrite or remove it. `category` groups the page alongside the generated ones and defaults to `custom`. Only the hub's owner can add pages, and the hub needs a finished first build: a hub whose knowledge store does not exist yet — one still `processing`, or a `draft` — answers 409 `KNOWLEDGE_HUB_NOT_READY`, and a hub with no knowledge pages at all (one built before the pages pipeline, and a draft that was never built) answers 409 `KNOWLEDGE_HUB_PAGES_UNAVAILABLE` first. Errors: - `404` `KNOWLEDGE_HUB_NOT_FOUND` — No hub with that id, it was deleted, or it belongs to another team. - `409` `KNOWLEDGE_HUB_NOT_READY` — The hub is still building, or its build never finished. - `409` `KNOWLEDGE_HUB_PAGES_UNAVAILABLE` — The hub predates knowledge pages. - `403` `KNOWLEDGE_HUB_OWNER_ONLY` — You can read this teammate's hub but only its owner can add pages. - `422` `VALIDATION_FAILED` — title or content missing or too long, or an unknown category. - `500` `UNEXPECTED_ERROR` — The page was saved but could not be indexed; edit it (PATCH) to retry the indexing. - `429` `RATE_LIMITED` — More than 30 knowledge-hub/campaign requests in a minute (or 1000 in a day). Knowledge hubs share the campaigns bucket. Requires one of the following token scopes: campaigns. ## OpenAPI ````yaml /openapi.json post /business/knowledge-hubs/{hubId}/pages openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/knowledge-hubs/{hubId}/pages: post: tags: - Knowledge hubs summary: Add a custom knowledge page description: >- Adds a page you author yourself to the hub and indexes it into the hub's knowledge store before answering — no polling. The page is stored with `origin` `user`, which means the hub's rebuilds never overwrite or remove it. `category` groups the page alongside the generated ones and defaults to `custom`. Only the hub's owner can add pages, and the hub needs a finished first build: a hub whose knowledge store does not exist yet — one still `processing`, or a `draft` — answers 409 `KNOWLEDGE_HUB_NOT_READY`, and a hub with no knowledge pages at all (one built before the pages pipeline, and a draft that was never built) answers 409 `KNOWLEDGE_HUB_PAGES_UNAVAILABLE` first. Errors: - `404` `KNOWLEDGE_HUB_NOT_FOUND` — No hub with that id, it was deleted, or it belongs to another team. - `409` `KNOWLEDGE_HUB_NOT_READY` — The hub is still building, or its build never finished. - `409` `KNOWLEDGE_HUB_PAGES_UNAVAILABLE` — The hub predates knowledge pages. - `403` `KNOWLEDGE_HUB_OWNER_ONLY` — You can read this teammate's hub but only its owner can add pages. - `422` `VALIDATION_FAILED` — title or content missing or too long, or an unknown category. - `500` `UNEXPECTED_ERROR` — The page was saved but could not be indexed; edit it (PATCH) to retry the indexing. - `429` `RATE_LIMITED` — More than 30 knowledge-hub/campaign requests in a minute (or 1000 in a day). Knowledge hubs share the campaigns bucket. Requires one of the following token scopes: campaigns. operationId: createKnowledgeHubPage parameters: - name: hubId in: path required: true description: >- 24-character hex id of the knowledge hub (from GET /business/knowledge-hubs). schema: type: string description: >- 24-character hex id of the knowledge hub (from GET /business/knowledge-hubs). requestBody: required: true content: application/json: schema: type: object properties: title: type: string minLength: 1 maxLength: 200 description: Page title (1-200 characters). content: type: string minLength: 1 maxLength: 60000 description: >- Page body in Markdown (1-60,000 characters); indexed into the hub's knowledge store as soon as the page is created. category: type: string enum: - overview - products - pricing - icp-use-cases - differentiators - competitors - faq - source-digest - custom description: >- Page category, one of overview (company summary), products, pricing, icp-use-cases (ideal customers and use cases), differentiators, competitors, faq, source-digest (digest of one source), custom (user-authored); defaults to custom. required: - title - content responses: '201': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object required: - page properties: page: type: object required: - id - title - content - category - origin - createdAt - updatedAt properties: id: type: - string - 'null' title: type: - string - 'null' content: type: - string - 'null' description: The page body in Markdown. category: type: - string - 'null' enum: - overview - products - pricing - icp-use-cases - differentiators - competitors - faq - source-digest - custom - null origin: type: - string - 'null' enum: - generated - edited - user - null description: >- generated = synthesized from the hub's sources, edited = a generated page you have since edited, user = a page you authored. createdAt: type: - string - 'null' format: date-time updatedAt: type: - string - 'null' format: date-time example: page: id: 68a1fc209c41d20014b3f302 title: Objection handling content: Price too high -> value framing. category: custom origin: user createdAt: '2026-08-24T19:14:55.387Z' updatedAt: '2026-08-24T19:14:55.387Z' '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ````