Publish / Unpublish

Toggle a form between published and draft status. Published forms accept submissions; drafts do not.

forms.publish
PUT/v1/forms/:id/publish

Request Body

ParameterTypeDescription
publishbooleantrue to publish, false to unpublish (default: true)

Publish a Form

curl
curl -X PUT "https://proforms.io/api/v1/forms/f_abc123/publish" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "publish": true }'

Unpublish a Form

curl
curl -X PUT "https://proforms.io/api/v1/forms/f_abc123/publish" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "publish": false }'

Response

200 OK
{
  "success": true,
  "data": {
    "id": "f_abc123",
    "status": "published",
    "updatedAt": "2026-02-17T11:00:00.000Z"
  }
}
ℹī¸
Calling without a body defaults to publishing. Send {"publish": false} to unpublish.
⚠ī¸
Unpublishing a form will immediately stop it from accepting submissions. Any embedded forms will show the "closed" message.