Skip to main content
POST
/
v3
/
ai-sdr
/
knowledge-bases
/
{knowledge_base_id}
/
reengagement-cards
Create a reengagement card
curl --request POST \
  --url https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/reengagement-cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "30-day silent prospect",
  "instructions": "Gentle nudge with new case study; no hard ask.",
  "sendAfter": 30,
  "toneOfVoice": "empathetic",
  "responseLength": "short",
  "links": [
    "https://example.com/case-study-northstar"
  ],
  "isEnabled": true,
  "isAutoSend": false
}
'
{
  "id": "9c1f8a7e-0b3a-4d11-9b9c-2c4f8a7e0b3a",
  "name": "30-day silent prospect",
  "instructions": "Gentle nudge with new case study; no hard ask.",
  "sampleAnswer": "Hi {{firstName}}, just sharing a quick case study...",
  "sendAfter": 30,
  "toneOfVoice": "empathetic",
  "responseLength": "short",
  "links": [
    "https://example.com/case-study-northstar"
  ],
  "media": [
    {
      "id": 12345,
      "fileName": "case-study-thumbnail.png",
      "size": 248
    }
  ],
  "isEnabled": true,
  "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 reengagement card.

name
string
required

Display name of the card

Required string length: 1 - 256
instructions
string
required

Instructions for what the reengagement message should say

Required string length: 1 - 2048
sendAfter
integer
required

Number of days after the last contact before this card fires

Required range: x >= 1
sampleAnswer
string

Optional sample reengagement message 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
isEnabled
boolean

Whether the card should be created in the enabled state (defaults to true on create)

isAutoSend
boolean

Whether generated reengagement messages should be auto-sent without manual review

Response

Reengagement card created successfully

Detailed representation of a reengagement card.

id
string<uuid>
read-only

Unique identifier for the reengagement card

name
string

Display name of the card

instructions
string

Instructions for what the reengagement message should say

sampleAnswer
string

Optional sample reengagement message used as a few-shot example

sendAfter
integer

Number of days after the last contact before this card fires

Required range: x >= 1
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 the AI SDR can quote when generating a reengagement message

media
KnowledgeBaseMedia · object[]
read-only

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

isEnabled
boolean

Whether the card is currently active

isAutoSend
boolean

Whether generated reengagement messages should be auto-sent without manual review

createdAt
string<date-time>
read-only

Timestamp when the card was created