Create a presentation

Creates a personalized presentation for a homeowner. The address is validated via Google Geocoding. Returns a shareable URL immediately; audio generation may continue in the background.

Price inputs are optional. If a product pricing slide uses formula variables that are not supplied, the price is deferred — the slide displays a placeholder instead of failing. Deferred prices can be resolved later when the missing values become available (e.g., after roof measurements).

POST /api/decks/{deckId}/presentations

Create a presentation

cURL

curl --request POST \
  --url https://app.demand-iq.com/api/decks/{deckId}/presentations \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "homeowner": {
    "first_name": "<string>",
    "address": "<string>",
    "city": "<string>",
    "country": "US",
    "last_name": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "email": "[e-mail]",
    "phone": "<string>"
  },
  "voice_settings": {},
  "language_settings": {},
  "price_inputs": {},
  "measurement_strategy": "manual"
}
'

200

{
  "deck_presentation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "url": "<string>"
}

Authorizations

session · string · cookie · required

Session cookie obtained from POST /api/auth/login.

Path Parameters

deckId · string<uuid> · required

UUID of the deck

Body

application/json

homeowner · object · required

Show child attributes

voice_settings · object

language_settings · object

price_inputs · object

Values for deck-level price variables (used to evaluate formulas). Optional — omitted variables result in deferred pricing rather than an error.

Show child attributes

measurement_strategy · enum<string> · default: manual

Available options: manual, auto

Response

200

application/json

Presentation created

deck_presentation_id · string<uuid>

url · string<uri>

Shareable presentation URL

status · enum<string>

Available options: not_started, pending, processing, ready, failed