---
title: "generate forms"
method: POST
path: "/v{version}/companies/{id}/enrollment-forms"
tags: ["Form"]
---

# generate forms

`POST /v{version}/companies/{id}/enrollment-forms`

Queues a form generation request and pings the caller back with a webhook once the generation is complete.<p>Scopes: employee_navigator</p>

## Path parameters

- `version` string, required
- `id` string, required

## Query parameters

- `id` string, required

## Request body

- DtosFormGenerationRequest — The request to generate forms with a callback URL.
  - `callback_url` string, required — The URL that a notification will be sent to once the report is completed. The payload will contain the URL of the report for retrieval. Example payload: { "url": "https://secure.ease.com/v2/files?foo=bar", "status": "Success" }
  - `employee_ids` string[] — The employees to limit the forms generation to. Optional.
  - `carrier_ids` string[] — The carriers to limit the forms generation to. Optional.
  - `plan_ids` string[] — The plans to limit the forms generation to. Optional.

## Response `200`

Success

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)