Quote requests: for your web person
Last updated
For the person who looks after the maker’s website or CRM. The maker turns these on in their admin, under Install. The no-code steps (Zapier, Make, NetSuite) are in quote requests into your CRM.
Quote requests are sent only to the webhook address the maker sets in the admin. We never send them anywhere else. Stopping is one click (Stop sending).
Each new quote request, sent to a webhook
When a buyer sends a quote request, the configurator POSTs it as JSON to the webhook URL set in the admin, within seconds. Any system that accepts a webhook works, with no Zapier in between. (Using Zapier? Check its plan first: see the CRM page.)
What is sent
POST <the webhook URL>
Content-Type: application/json
User-Agent: IronMile-Studio-Webhook/1
X-Studio-Event: enquiry.created
X-Studio-Delivery: 5f1c0a4e9b2d4c7e8a6f3b1d2c4e6a8b
Idempotency-Key: 5f1c0a4e9b2d4c7e8a6f3b1d2c4e6a8b
X-Studio-Timestamp: 1760438400
X-Studio-Signature: v1=3b5c…(64 hex characters)
{
"event": "enquiry.created",
"version": 1,
"delivery_id": "5f1c0a4e9b2d4c7e8a6f3b1d2c4e6a8b",
"enquiry": {
"id": "0d7f4a52-6c1e-4b8e-9f20-6a1b2c3d4e5f",
"created_at": "2026-10-14T10:00:00.000Z",
"product": "cabin",
"product_name": "Trail cabin",
"contact": { "name": "Jordan Avery", "email": "jordan@example.com", "phone": "+1 512 555 0147", "site": "Austin, TX" },
"notes": "Wooded lot, gravel road",
"config": { "size": "l", "porch": "deep" },
"build": [
{ "option": "Size", "choice": "14 × 24 ft", "price": 36500, "priced_in_quote": false },
{ "option": "Porch", "choice": "8 ft porch", "price": 4200, "priced_in_quote": false }
],
"size": "",
"total": 40700,
"total_text": "$40,700",
"starting_price": false,
"currency": "USD",
"price_note": "Delivery quoted separately.",
"sheet": "Trail cabin\nSize: 14 × 24 ft — $36,500\n…",
"page": "https://your-configurator-address/",
"link": "https://your-configurator-address/#size=l&porch=deep",
"status": "new",
"attribution": {}
}
}
| Field | Meaning |
|---|---|
enquiry.id | The quote request’s id; the same in the admin, the read API and “Download my data”. |
config | The buyer’s choices, by option id and choice id (a multiple choice is several ids). |
build | The same choices with their labels and prices, as the buyer saw them. priced_in_quote: that choice is priced in the maker’s quote, not online. |
total, currency | The price shown to the buyer, in the currency’s units (cents as a fraction). starting_price true: the build has choices priced in the quote, so the total is a starting figure. |
link | Opens this exact build in the configurator. |
attribution | Where the buyer came from, when ad tracking is on (ad click ids and utm_ values). Empty otherwise. |
Retries and duplicates
Any 2xx answer counts as delivered. Anything else (or no answer in 10 seconds, or a redirect, which is not followed) is tried again after about 1 minute, 5 minutes, 30 minutes, 2 hours, 8 hours and 24 hours: 7 tries in all, then it is marked failed. The admin’s Recent deliveries list shows each one, with Send again.
Every try of one message carries the same body and the same Idempotency-Key (also X-Studio-Delivery). If your system can receive the same delivery twice, keep the keys you have seen and skip repeats.
Checking the signature (optional, recommended for your own endpoint)
The admin shows the signing secret (whsec_…) once, when the webhook is first saved, and again only when you make a new one. The signature is HMAC-SHA256 of <X-Studio-Timestamp>.<raw body> with the secret, in hex, after v1=. Use the raw body bytes, before any JSON parsing; refuse old timestamps (more than 5 minutes) to stop replays.
// Node.js (Express: app.post('/studio', express.raw({ type: 'application/json' }), handler))
import { createHmac, timingSafeEqual } from 'node:crypto';
function fromStudio(req, secret) {
const ts = req.get('X-Studio-Timestamp');
const sig = req.get('X-Studio-Signature') ?? '';
if (!ts || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const want = 'v1=' + createHmac('sha256', secret).update(`${ts}.${req.body}`).digest('hex');
return sig.length === want.length && timingSafeEqual(Buffer.from(sig), Buffer.from(want));
}
<?php
// PHP
$secret = getenv('STUDIO_WEBHOOK_SECRET');
$body = file_get_contents('php://input');
$ts = $_SERVER['HTTP_X_STUDIO_TIMESTAMP'] ?? '';
$sig = $_SERVER['HTTP_X_STUDIO_SIGNATURE'] ?? '';
$want = 'v1=' . hash_hmac('sha256', $ts . '.' . $body, $secret);
if (!ctype_digit($ts) || abs(time() - (int)$ts) > 300 || !hash_equals($want, $sig)) { http_response_code(401); exit; }
$enquiry = json_decode($body, true)['enquiry'];
# Python
import hashlib, hmac, time
def from_studio(headers, raw_body: bytes, secret: str) -> bool:
ts = headers.get('X-Studio-Timestamp', '')
if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
return False
want = 'v1=' + hmac.new(secret.encode(), ts.encode() + b'.' + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(want, headers.get('X-Studio-Signature', ''))
Reading quote requests from your own software (a key)
In the admin, Install → Keys for your web person → Create a key. The key is shown once; it can only read quote requests. Revoke it there when it is no longer used.
curl -H "Authorization: Bearer <key>" "https://your-configurator-address/api/v1/enquiries?limit=50"
{
"items": [ { "id": "…", "created_at": "…", "product": "cabin", "contact": { … }, "notes": "…", "config": { … },
"sheet": "…", "size": "", "total": 40700, "currency": "USD", "page": "…", "link": "…",
"status": "new", "attribution": {} } ],
"next": "r_1042",
"more": false
}
In the order they arrived, at most 100 per call (limit, default 50). Keep next and send it as ?after=<next> on the next call: you get only what is new, never a request twice. more: true means call again straight away. A wrong or revoked key gets 401.
status is the maker’s own status in the admin (new, contacted, quoted, won, lost) at the time of reading.