> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/llms.txt)

# Create Public Links

> POST /profiles/{profile_id}/public_links
> 
> Creates a public link for each form in the body. A form has at most one public link. Send one object or an array of objects.
> 
> ### Authorization
> 
> - SERVER users: any form in the profile.
> - COMPANY users: any form of their own profile that is not shared into it from another profile.
> - BASIC users: only forms they created, and only with the Form Builder role.
> 
> An internal API client gets no exemption: it passes only when its user does. Permission is checked for every form in the body before anything is written, so one form the caller cannot modify fails the whole request with `403`.



## Servers
- https://api.iformbuilder.com/exzact/api/v80/[servername]: https://api.iformbuilder.com/exzact/api/v80/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile



### Body: application/json (object)

- **page_id** (integer)
  id of a form in the profile; it must not already have a public link

- **name** (string)

- **label** (string)

- **activation_date** (string)
  date and time the link starts accepting submissions, for example `2026-12-01T00:00:00Z`

- **expiration_date** (string)
  date and time the link stops accepting submissions

- **is_disabled** (boolean)

- **password** (string)
  when non-empty, submitters must enter it; stored RSA-encrypted



## Responses
### 201
Created - every item succeeded. A single object in the body answers a single `{id}`; an array answers an array in request order.

#### Body: application/json (object)
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 207
Multi-Status - some items were created and some failed. Each failed item carries `error_message`.

#### Body: application/json (array[object])
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 400
Bad Request - every item failed (for example a missing or invalid `page_id`, the form already has a public link, or public links are not enabled on this server). The body has the same shape as `201`, with `error_message` on each item.

#### Body: application/json (object)
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the caller cannot modify one of the forms in the body (see Authorization), or `profile_id` is not the caller's own profile. Nothing is created.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 404
Not Found - a `page_id` in the body is a page of the profile but not a form (for example a page group).

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure



[Powered by Bump.sh](https://bump.sh)
