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.
Responses
-
Created - every item succeeded. A single object in the body answers a single
{id}; an array answers an array in request order. -
Multi-Status - some items were created and some failed. Each failed item carries
error_message. -
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 as201, witherror_messageon each item. -
Unauthorized - missing or invalid bearer token.
-
Forbidden - the caller cannot modify one of the forms in the body (see Authorization), or
profile_idis not the caller's own profile. Nothing is created. -
Not Found - a
page_idin the body is a page of the profile but not a form (for example a page group).
curl \
--request POST 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/public_links' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer {access_token}" \
--data '{
"page_id": 290749032,
"name": "Site Inspection",
"activation_date": "2026-12-01T00:00:00Z",
"expiration_date": "2027-01-01T00:00:00Z",
"password": "s3cret-pass"
}'
{
"page_id": 290749032,
"name": "Site Inspection",
"activation_date": "2026-12-01T00:00:00Z",
"expiration_date": "2027-01-01T00:00:00Z",
"password": "s3cret-pass"
}
{
"id": 41
}
[
{
"id": 41
},
{
"error_message": "Public Link for page_id 290749033 already exists"
}
]
{
"id": 42,
"error_message": "string"
}
[
{
"id": 42,
"error_message": "string"
}
]
{
"error_message": "string"
}
{
"error_message": "string"
}