Start an assisted application interview (Bindly form filler)

POST

/broker/submissions/{submission_id}/form-fill-session

const url = 'https://api.hedgespecialty.com/api/v1/broker/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/form-fill-session';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"form_keys":["example"]}'
};

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/submissions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/form-fill-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "form_keys": [ "example" ] }'

Spawns the embedded form-filler session that walks the insured or producer through the application forms Hedge resolved for the risk (ACORD baseline plus recommended supplements). Returns a token bridge you embed or link to; the completed forms land on the submission as finalized documents. Required forms are always kept even when form_keys trims the set. Requires broker_submit.

Authorizations

brokerOAuth

Parameters

Path Parameters

submission_id

required

string format: uuid

Request Body

application/json

object

form_keys

Optional trim of the resolved form set (see GET /broker/forms).

Array<string>

Example^generated

{
  "form_keys": [
    "example"
  ]
}

Responses

200

{session_id, workflow_version, token, auth_mode, forms_assigned, status, carrier_schemas}

404

Not found (or not your brokerage’s)