Create a submission from documents and/or text (the portal's Upload documents)
const url = 'https://api.hedgespecialty.com/api/v1/broker/intake';const form = new FormData();form.append('text', 'example');form.append('files', 'file');form.append('insured_name', 'example');form.append('effective_date', '2026-04-15');form.append('lines_of_business', 'example');form.append('primary_state', 'example');form.append('producer_email', 'example');form.append('hold', 'false');form.append('program_ids', 'example');form.append('client_reference', 'example');form.append('quote', 'false');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.hedgespecialty.com/api/v1/broker/intake \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form text=example \ --form files=@file \ --form insured_name=example \ --form effective_date=2026-04-15 \ --form lines_of_business=example \ --form primary_state=example \ --form producer_email=example \ --form hold=false \ --form program_ids=example \ --form client_reference=example \ --form quote=falseThe API form of the portal’s Upload documents. Send free text
(an email body, notes), documents (ACORDs, loss runs, supplements),
or both. Hedge reads them as the portal does (the insured, address,
NAICS, lines, effective date, locations), prefills a structured file
for Hedge Instant Quote markets only and returns the same
response as POST /broker/submissions: each market’s state. Your
typed fields win over what Hedge read. Emails follow your brokerage’s
notification settings; the defaults match the portal. The documents stay on the file and keep
feeding its prefill; identical files in one call are stored once.
When what Hedge read fits no instant market (or names no lines or
state) it returns 422 no_instant_market (or missing_core) with
email_us and read (what it could read), and creates nothing.
Requires text, insured_name or documents. Machine credentials
must name producer_email. client_reference and an
Idempotency-Key header make a retry return the saved file. Counts
toward the daily create and upload limits.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”object
The risk as you would describe it in an email. Required unless insured_name is given.
Up to 20 PDFs (ACORDs, loss runs, supplements), 15 MB each.
Comma-separated canonical slugs or common aliases (e.g. gl,property).
Primary risk state, 2-letter US code.
REQUIRED when authenticating with a machine credential; the active portal user this submission is attributed to.
Accepted and changes nothing for a connected app or machine credential.
Comma-separated Hedge Instant Quote program ids (default every one that fits).
Your reference; unique per brokerage (a repeat returns that file, 200).
Quote each market as soon as it is ready.
Responses
Section titled “Responses”Created; each instant market’s state.
Result of POST /broker/intake.
object
Null for an instant-flow file (it never starts marketing).
One Hedge Instant Quote program on the file and where it stands.
object
preparing: Hedge is preparing the application (poll). needs_answers: answer missing[]. ready: request the quote. quoting: requested. quoted: quote is set. declined / not_a_fit: closed, with reason.
Plain words: Preparing · Needs 2 answers · Ready to quote · Quoting · Quoted · $1,234.00 · Declined · reason · Not a fit · reason.
object
The canonical key (what shared_answers takes); null for a file-level gap.
The market’s own question id (what answers[program_id] takes).
Plain-language note on what to do. A gap in the business’s own name, address, contact or effective date names the call that sets it: PATCH /broker/submissions/{id}/business and its field.
object
Dollars.
Dollars
A class Hedge picked, or ranked for an unanswered class question, that you must confirm (the same ranking POST /broker/appetite/instant returns). Confirm it with confirm_suggestions, by answering with the same value, or answer another.
object
The originals stored on the submission, in upload order.
object
What Hedge recorded for the insured, your fields, or the extractor’s when you only sent text.
object
object
Non-fatal notices (a file that was not stored, a background enqueue that needs attention, a replayed request).
Example
{ "marketing_status": "matching", "markets": [ { "state": "preparing", "quote": { "kind": "quote" } } ]}A file is not a valid PDF/document
Same Idempotency-Key already in flight
A file is over the 15 MB limit
Unsupported document type
{code: no_instant_market, email_us, read} (nothing created); {code: missing_core, fields, read}; no text, insured_name or documents; missing producer_email for a machine credential; invalid date, state or line of business
Daily create limit reached
Text extraction is temporarily unavailable; your text is preserved