FormfexDocs
POST/forms/:id/publish

Publish Form

Publish a draft form to start collecting responses

Scope: FORMS_WRITE

Overview

Publishes a draft form, generating a unique share URL and making it available for submissions. You can choose between public (anyone with the link) or private (email whitelist) visibility.

Request

POST/forms/:id/publish

Path Parameters

Headers

HeaderValue
AuthorizationBearer fxk_live_<your-api-key>
Content-Typeapplication/json

Request Body

Example Request

curl -X POST "https://api.formfex.com/api/v1/public/forms/FORM_ID/publish" \
  -H "Authorization: Bearer $FORMFEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "visibility": "PUBLIC",
    "expiresAt": "2026-06-01T00:00:00.000Z"
  }'

Response

Error Cases

StatusCondition
403Form is already published
403PRIVATE visibility requires a plan with private forms feature
404Form not found or soft-deleted

Share URL

A unique 10-character share URL is generated automatically on publish. The full form URL will be: https://formfex.com/f/{shareUrl}

Webhooks & Integrations

Publishing a form triggers the FORM_PUBLISHED webhook event and sends notifications to configured Slack or Teams integrations.

Private Forms

Private forms require the privateForms feature, available on Pro and Max plans. Only the specified email addresses can access and submit the form.

n8n

In n8n, this operation is available as Publish under the Form resource in the Formfex node.

PreviousDelete FormNextUnpublish Form