---
title: "Create a Knowledge Base"
method: POST
path: "/v2/ControlPlane/KnowledgeBases"
tags: ["KnowledgeBases"]
---

# Create a Knowledge Base

`POST /v2/ControlPlane/KnowledgeBases`

Create a new Knowledge Base for the Twilio account. Accounts can have multiple knowledge bases. Each knowledge base can contain multiple knowledge resources such as documents, websites, or text content that can be used for context and information retrieval.

## Request body

- KnowledgeBaseCore
  - `displayName` string, required — Provides a unique and addressable name to be assigned to this Knowledge Base. This name is assigned by the developer and can be used in addition to the ID. It is intended to be human-readable and unique within the account.
  - `description` string — A human readable description of this resource, up to 128 characters.

## Response `202`

Knowledge Base creation request accepted.

- object
  - `message` string
  - `statusUrl` string — URI to check operation status.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/twilio/apis/knowledge-v2.md) · [All operations](https://skmtc.dev/twilio/apis/knowledge-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/knowledge-v2/revisions/36dc1dbda0b4/schema)