Skip to main content
POST
/
v3
/
ai-sdr
/
knowledge-bases
/
{knowledge_base_id}
/
reply-handlers
Create a reply handler
curl --request POST \
  --url https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/reply-handlers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "typeOfQuestion": "Pricing inquiry",
  "instructions": "Quote our published tiered pricing; offer a discovery call for enterprise.",
  "sampleAnswer": "Thanks for asking! Our tiered pricing starts at $X...",
  "toneOfVoice": "confident",
  "responseLength": "medium",
  "links": [
    "https://example.com/pricing"
  ],
  "isAutoSend": false
}
'
{
  "id": "9c1f8a7e-0b3a-4d11-9b9c-2c4f8a7e0b3a",
  "typeOfQuestion": "Pricing inquiry",
  "instructions": "Quote our published tiered pricing; offer a discovery call for enterprise.",
  "sampleAnswer": "Thanks for asking! Our tiered pricing starts at $X...",
  "toneOfVoice": "confident",
  "responseLength": "medium",
  "links": [
    "https://example.com/pricing"
  ],
  "media": [
    {
      "id": 12345,
      "fileName": "pricing-tiers.png",
      "size": 248
    }
  ],
  "isAutoSend": false,
  "createdAt": "2026-05-10T14:32:11Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

knowledge_base_id
integer<int64>
required
Required range: x >= 1

Body

application/json

Request body for creating a new reply handler.

typeOfQuestion
string
required

Short label describing the type of incoming reply this handler covers

Required string length: 1 - 256
instructions
string
required

Instructions for how to handle replies of this type

Required string length: 1 - 2048
sampleAnswer
string

Optional sample answer used as a few-shot example

Maximum string length: 1024
toneOfVoice
enum<string>

Tone applied to generated replies and reengagement messages.

Available options:
confident,
persuasive,
witty,
straightforward,
empathetic
responseLength
enum<string>

Target length of generated replies and reengagement messages.

Available options:
superShort,
short,
medium,
long

Reference URLs (max 10; each non-empty, max 256 chars)

Maximum array length: 10
Required string length: 1 - 256
isAutoSend
boolean

Whether replies matching this handler should be auto-sent without manual review

Response

Reply handler created successfully

Detailed representation of a reply handler.

id
string<uuid>
read-only

Unique identifier for the reply handler

typeOfQuestion
string

Short label describing the type of incoming reply this handler covers

instructions
string

Instructions for how to handle replies of this type

sampleAnswer
string

Optional sample answer used as a few-shot example

toneOfVoice
enum<string>

Tone applied to generated replies

Available options:
confident,
persuasive,
witty,
straightforward,
empathetic
responseLength
enum<string>

Target length for generated replies

Available options:
superShort,
short,
medium,
long

Reference URLs the AI SDR can quote when generating a reply

media
KnowledgeBaseMedia · object[]
read-only

Media items attached to this reply handler. Managed via the /media sub-resource.

isAutoSend
boolean

Whether replies matching this handler should be auto-sent without manual review

createdAt
string<date-time>
read-only

Timestamp when the reply handler was created