POST
/smart-forms/:id/publishPublish Smart Form
Publish a smart form to start accepting respondent sessions
Scope: SMART_FORMS_WRITE
Overview
Transitions a smart form from DRAFT to PUBLISHED status and enables new sessions. Once published, respondents can start interviews via the short share URL. Returns a 409 error if the form is already published.
Request
POST
/smart-forms/:id/publishHeaders
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Path Parameters
Example Request
curl -X POST "https://api.formfex.com/api/v1/public/smart-forms/SMART_FORM_ID/publish" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Error Cases
| Status | Description |
|---|---|
401 | Invalid or missing API key |
404 | Smart form not found or not owned by this API key |
409 | Smart form is already published |
Share URL
After publishing, respondents can access the interview at https://formfex.com/sf/{shortId}. The shortId is included in the response.
n8n
In n8n, this operation is available as Publish under the Smart Form resource in the Formfex node.