Skip to main content
POST
/
v3
/
ai-sdr
/
offers
Create an offer
curl --request POST \
  --url https://api.reply.io/v3/ai-sdr/offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Q3 Enterprise Outbound",
  "companyName": "Acme Robotics",
  "companyDescription": "AI-driven warehouse automation for mid-market logistics.",
  "icp": "Director of Operations at logistics companies with 200+ warehouse staff",
  "reasonForOutreach": "Q3 push into mid-market logistics.",
  "caseStudies": [
    "Reduced order-pick errors 38% at NorthStar Logistics"
  ],
  "painPoints": [
    "Manual pick-pack errors driving customer churn"
  ],
  "proofPoints": [
    "Used by 4 of top 10 mid-market 3PLs"
  ],
  "valuePropositions": [
    "30% pick-rate improvement in 90 days"
  ],
  "callToActions": [
    "15-min demo this week?"
  ]
}
'
{
  "id": 4821,
  "name": "Q3 Enterprise Outbound",
  "companyName": "Acme Robotics",
  "companyDescription": "AI-driven warehouse automation for mid-market logistics.",
  "icp": "Director of Operations at logistics companies with 200+ warehouse staff",
  "reasonForOutreach": "Q3 push into mid-market logistics — Acme just closed a marquee customer in this segment.",
  "caseStudies": [
    "Reduced order-pick errors 38% at NorthStar Logistics"
  ],
  "painPoints": [
    "Manual pick-pack errors driving customer churn",
    "Labor cost rising 12% YoY"
  ],
  "proofPoints": [
    "Used by 4 of top 10 mid-market 3PLs"
  ],
  "valuePropositions": [
    "30% pick-rate improvement in 90 days"
  ],
  "callToActions": [
    "15-min demo this week?"
  ]
}

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.

Body

application/json

Request body for creating a new offer.

name
string
required

Display name of the offer

Required string length: 1 - 200
companyName
string

The company being represented in outreach

Maximum string length: 200
companyDescription
string

Short description of what the company does

Maximum string length: 1000
icp
string

Ideal Customer Profile

Maximum string length: 1000
reasonForOutreach
string

Free-form rationale for the outreach

Maximum string length: 1000
caseStudies
string[]

Case studies (max 10; each non-empty, max 1000 chars)

Maximum array length: 10
Required string length: 1 - 1000
painPoints
string[]

Customer pain points (max 10; each non-empty, max 1000 chars)

Maximum array length: 10
Required string length: 1 - 1000
proofPoints
string[]

Proof points (max 10; each non-empty, max 1000 chars)

Maximum array length: 10
Required string length: 1 - 1000
valuePropositions
string[]

Value propositions (max 10; each non-empty, max 1000 chars)

Maximum array length: 10
Required string length: 1 - 1000
callToActions
string[]

Call-to-action phrasings (max 10; each non-empty, max 1000 chars)

Maximum array length: 10
Required string length: 1 - 1000

Response

Offer created successfully

Detailed representation of an offer — the bundle of company-context inputs the AI SDR uses to personalize outreach. Returned by get/create/update responses.

id
integer<int64>
read-only

Unique identifier for the offer

name
string

Display name of the offer

companyName
string

The company being represented in outreach

companyDescription
string

Short description of what the company does

icp
string

Ideal Customer Profile — who the offer is meant for

reasonForOutreach
string

Free-form rationale shown to the AI SDR for why this outreach is being made

caseStudies
string[]

Case studies that demonstrate the company's value

painPoints
string[]

Customer pain points this offer addresses

proofPoints
string[]

Proof points that back up the offer's claims

valuePropositions
string[]

Value propositions presented in messaging

callToActions
string[]

Call-to-action phrasings the AI SDR can use