---
title: "Create an offer"
method: POST
path: "/v3/ai-sdr/offers"
tags: ["AI SDR Offers"]
---

# Create an offer

`POST /v3/ai-sdr/offers`

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

Creates a new offer. Only `name` is strictly required; all other fields default to empty.

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

## Request body

- object — Request body for creating a new offer.
  - `name` string, required — 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
  - `reasonForOutreach` string — Free-form rationale for the outreach
  - `caseStudies` string[] — Case studies (max 10; each non-empty, max 1000 chars)
  - `painPoints` string[] — Customer pain points (max 10; each non-empty, max 1000 chars)
  - `proofPoints` string[] — Proof points (max 10; each non-empty, max 1000 chars)
  - `valuePropositions` string[] — Value propositions (max 10; each non-empty, max 1000 chars)
  - `callToActions` string[] — Call-to-action phrasings (max 10; each non-empty, max 1000 chars)

## Response `201`

Offer created successfully

- object — 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 — 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

## Other responses

- `400` — Validation failure on the request body or upstream variable-validation rejection.
- `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 or read-back failure after create

---

[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)