---
title: "Create Forms URL"
method: POST
path: "/v1/public-access/form/"
tags: ["Public URLs"]
---

# Create Forms URL

`POST /v1/public-access/form/`

Create a public access URL for a set of form templates.

The generated link will return a list of forms matching the form templates that were submitted for the specified site.

## Request body

- PublicFormSubmitCreateModel — The configuration for form public access.
  - `name` string, required — Name of the new shared link
  - `siteId` integer, required — ID of the site that the forms were submitted to
  - `formIds` integer[], required — IDs of the form templates to include in the list

## Response `200`

Successful Response

- ApiGenericResponsePublicAccessSearchModel
  - `error` boolean — A boolean error indicator.
  - `message` string, nullable — Optional message.
  - `data` PublicAccessSearchModel — The required data to navigate to a public access URL.
    - `id` integer, required — The unique identifier for the public access bundle.
    - `url` string, required — The public URL to access this public access.
    - `name` string, required — The name of the item.
    - `entity` string, required — The type of entities at the specified URL.
    - `shortCode` string, nullable, required — For bundles, the short code that can be entered instead of scanning the QR code

## Other responses

- `400` — Business Logic Error
- `403` — Permission Error
- `409` — Integrity Error or Data Conflict
- `422` — Validation Error

---

[API](https://skmtc.dev/salussafety/apis/salus-developer-api.md) · [All operations](https://skmtc.dev/salussafety/apis/salus-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salussafety/salus-developer-api/revisions/ef065f44da25/schema)
