---
title: "Create a knowledge base"
method: POST
path: "/v3/ai-sdr/knowledge-bases"
tags: ["AI SDR Knowledge Bases"]
---

# Create a knowledge base

`POST /v3/ai-sdr/knowledge-bases`

<small>_Requires the `ai-sdr:write` scope (or a broader one that includes it)._</small>

Creates a new knowledge base. Only `name` is required.

Requires the AI SDR feature on the caller's team.

## Request body

- object — Request body for creating a new knowledge base.
  - `name` string, required — Display name of the knowledge base
  - `instructions` string — Free-form instructions applied when the knowledge base is referenced by AI SDR generations.

## Response `201`

Knowledge base created successfully

- object — Detailed representation of a knowledge base.
  - `id` integer — Unique identifier for the knowledge base
  - `name` string — Display name of the knowledge base
  - `instructions` string — Free-form instructions applied when the knowledge base is referenced by AI SDR generations.
  - `updatedAt` string, date-time — Timestamp of the last modification
  - `ownerUserId` integer, nullable — User ID of the owner. `null` when the owner has been removed from the team.

## Other responses

- `400` — Validation failure on the request body
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — AI SDR feature is not available for the caller's team
- `502` — Upstream AI SDR service failure

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)