CRUD operations for forms. All endpoints require manage_options capability.
GET /formforge/v1/forms
List all forms.
curl -s -u "admin:XXXX XXXX XXXX XXXX" \
https://example.com/wp-json/formforge/v1/forms[
{
"id": 1,
"title": "Contact Form",
"fields": [
{
"id": "field_1",
"type": "text",
"label": "Name",
"required": true,
"placeholder": "Your name"
},
{
"id": "field_2",
"type": "email",
"label": "Email",
"required": true,
"placeholder": "[email protected]"
}
],
"settings": {
"submit_text": "Submit",
"success_message": "Thank you!",
"notify_admin": true,
"notify_email": "[email protected]"
},
"status": "publish",
"created_at": "2025-01-15 10:30:00",
"updated_at": "2025-01-20 14:00:00"
}
]GET /formforge/v1/forms/{id}
Get a single form by ID.
curl -s -u "admin:XXXX XXXX XXXX XXXX" \
https://example.com/wp-json/formforge/v1/forms/1{
"id": 1,
"title": "Contact Form",
"fields": [
{
"id": "field_1",
"type": "text",
"label": "Name",
"required": true,
"placeholder": "Your name",
"description": "",
"min_length": 0,
"max_length": 0,
"regex": "",
"regex_message": ""
},
{
"id": "field_2",
"type": "email",
"label": "Email",
"required": true,
"placeholder": "[email protected]"
},
{
"id": "field_3",
"type": "textarea",
"label": "Message",
"required": true,
"placeholder": "How can we help?",
"rows": 6
}
],
"settings": {
"submit_text": "Send Message",
"success_message": "Thank you! We will get back to you within 24 hours.",
"redirect_url": "",
"notify_admin": true,
"notify_email": "[email protected]",
"webhook_url": "",
"css_class": ""
},
"conditional_logic": [],
"status": "publish",
"created_at": "2025-01-15 10:30:00",
"updated_at": "2025-01-20 14:00:00"
}POST /formforge/v1/forms
Create a new form. Send a JSON body with title, fields, and optionally settings and conditional_logic. The same license gate used by the admin builder runs on REST create/update: locked PRO field types are normalized before save, PRO-only settings are ignored until the license is current, and Free features such as File Upload, conditional logic, generic webhooks, and unlimited forms remain available.
curl -s -X POST -u "admin:XXXX XXXX XXXX XXXX" \
-H "Content-Type: application/json" \
https://example.com/wp-json/formforge/v1/forms \
-d '{
"title": "Newsletter Signup",
"fields": [
{
"id": "field_1",
"type": "email",
"label": "Email Address",
"required": true,
"placeholder": "[email protected]"
},
{
"id": "field_2",
"type": "text",
"label": "First Name",
"required": false,
"placeholder": "Your name"
}
],
"settings": {
"submit_text": "Subscribe",
"success_message": "You are subscribed!",
"notify_admin": true,
"notify_email": "[email protected]"
}
}'{
"id": 5
}PUT /formforge/v1/forms/{id}
Update an existing form. Partial updates are supported: only include the keys you want to change.
curl -s -X PUT -u "admin:XXXX XXXX XXXX XXXX" \
-H "Content-Type: application/json" \
https://example.com/wp-json/formforge/v1/forms/5 \
-d '{
"title": "Newsletter Signup v2",
"settings": {
"submit_text": "Join Now",
"success_message": "Welcome aboard!"
}
}'{
"success": true
}DELETE /formforge/v1/forms/{id}
Delete a form and all its submissions and analytics. This action is irreversible.
curl -s -X DELETE -u "admin:XXXX XXXX XXXX XXXX" \
https://example.com/wp-json/formforge/v1/forms/5{
"success": true
}> Warning: This permanently deletes the form, all submissions, and all analytics data for that form. There is no undo.
—