---
title: "Start an assisted application interview (Bindly form filler)"
method: POST
path: "/broker/submissions/{submission_id}/form-fill-session"
tags: ["Requirements"]
---

# Start an assisted application interview (Bindly form filler)

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

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/submissions/{submission_id}/form-fill-session`
- Auth: OAuth 2
  - Authorization code: `https://api.hedgespecialty.com/api/v1/oauth/authorize`
  - Client credentials
  - Token URL: `https://api.hedgespecialty.com/api/v1/oauth/token`

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`.

## Path parameters

- `submission_id` string, uuid, required

## Request body

- object
  - `form_keys` string[]: Optional trim of the resolved form set (see `GET /broker/forms`).

## Response `200`

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

## Other responses

- `404`: Not found (or not your brokerage's)

## Changes

- **2026-09-20** `7928528d98b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/changes/broker/submissions/:submission_id/form-fill-session/post.md)

---

[API](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api.md) - [All operations](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/revisions/beefa9cdc11c?raw)