Forms
Create a new form
Forms
Create a new form
Create a new form for the authenticated organization.
POST
/
forms
curl --request POST \
--url https://app.formbox.app/api/v1/forms \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"name": "<string>",
"type": "endpoint",
"removeFormboxBranding": false,
"sendEmailNotifications": true,
"emailsToNotify": [],
"submissionStorageDuration": "365",
"sendRespondantEmailNotifications": false,
"respondantEmailFromName": "<string>",
"respondantEmailSubject": "<string>",
"limitResponses": false,
"isClosed": false,
"maxResponses": null,
"useCustomThankYouPage": false,
"tpButtonText": "<string>",
"tpButtonColor": "#030712",
"tpButtonBackgroundColor": "#f3f4f6",
"tpBackgroundColor": "#ffffff",
"tpTextColor": "#030712",
"tpHeader": "<string>",
"tpMessage": "<string>",
"tpButtonUrl": "<string>",
"useCustomRedirect": false,
"customSuccessUrl": "<string>",
"customHoneypot": "<string>",
"googleRecaptchaEnabled": false,
"googleRecaptchaSecretKey": "<string>",
"allowedDomains": "example.com, example.org"
}'
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"submissionStorageDuration": "<string>",
"sendEmailNotifications": true,
"sendRespondantEmailNotifications": true,
"emailsToNotify": [
"<string>"
],
"allowedDomains": "<string>",
"customHoneypot": "<string>",
"limitResponses": true,
"maxResponses": 123,
"respondantEmailFromName": "<string>",
"respondantEmailSubject": "<string>",
"respondantEmailMessageHTML": "<string>",
"submitButtonText": "<string>",
"webhookEnabled": true,
"webhookUrl": "<string>",
"useCustomRedirect": true,
"customSuccessUrl": "<string>",
"useCustomThankYouPage": true,
"tpBackgroundColor": "<string>",
"tpTextColor": "<string>",
"tpButtonBackgroundColor": "<string>",
"tpButtonColor": "<string>",
"tpHeader": "<string>",
"tpMessage": "<string>",
"tpButtonText": "<string>",
"tpButtonUrl": "<string>",
"googleRecaptchaEnabled": true,
"googleRecaptchaSecretKey": "<string>",
"showCustomClosedMessage": true,
"closeMessageTitle": "<string>",
"closeMessageDescription": "<string>",
"headerTitle": "<string>",
"headerDescription": "<string>",
"pageMode": "compact",
"backgroundColor": "<string>",
"textColor": "<string>",
"buttonBackgroundColor": "<string>",
"buttonTextColor": "<string>",
"accentColor": "<string>",
"buttonBorderStyle": "full",
"inputBorderStyle": "full",
"headerImage": "<string>",
"logo": "<string>",
"fields": [
{
"id": "<string>",
"label": "<string>",
"description": "<string>",
"type": "<string>",
"subtype": "<string>",
"required": true,
"ratingCount": 123,
"options": [
{
"id": "<string>",
"value": "<string>"
}
],
"showDescription": true
}
],
"removeFormboxBranding": true,
"isClosed": true,
"orgId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
Headers
The API key.
Body
application/json
Response
200
application/json
The newly created form.
The response is of type object
.
curl --request POST \
--url https://app.formbox.app/api/v1/forms \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '{
"name": "<string>",
"type": "endpoint",
"removeFormboxBranding": false,
"sendEmailNotifications": true,
"emailsToNotify": [],
"submissionStorageDuration": "365",
"sendRespondantEmailNotifications": false,
"respondantEmailFromName": "<string>",
"respondantEmailSubject": "<string>",
"limitResponses": false,
"isClosed": false,
"maxResponses": null,
"useCustomThankYouPage": false,
"tpButtonText": "<string>",
"tpButtonColor": "#030712",
"tpButtonBackgroundColor": "#f3f4f6",
"tpBackgroundColor": "#ffffff",
"tpTextColor": "#030712",
"tpHeader": "<string>",
"tpMessage": "<string>",
"tpButtonUrl": "<string>",
"useCustomRedirect": false,
"customSuccessUrl": "<string>",
"customHoneypot": "<string>",
"googleRecaptchaEnabled": false,
"googleRecaptchaSecretKey": "<string>",
"allowedDomains": "example.com, example.org"
}'
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"submissionStorageDuration": "<string>",
"sendEmailNotifications": true,
"sendRespondantEmailNotifications": true,
"emailsToNotify": [
"<string>"
],
"allowedDomains": "<string>",
"customHoneypot": "<string>",
"limitResponses": true,
"maxResponses": 123,
"respondantEmailFromName": "<string>",
"respondantEmailSubject": "<string>",
"respondantEmailMessageHTML": "<string>",
"submitButtonText": "<string>",
"webhookEnabled": true,
"webhookUrl": "<string>",
"useCustomRedirect": true,
"customSuccessUrl": "<string>",
"useCustomThankYouPage": true,
"tpBackgroundColor": "<string>",
"tpTextColor": "<string>",
"tpButtonBackgroundColor": "<string>",
"tpButtonColor": "<string>",
"tpHeader": "<string>",
"tpMessage": "<string>",
"tpButtonText": "<string>",
"tpButtonUrl": "<string>",
"googleRecaptchaEnabled": true,
"googleRecaptchaSecretKey": "<string>",
"showCustomClosedMessage": true,
"closeMessageTitle": "<string>",
"closeMessageDescription": "<string>",
"headerTitle": "<string>",
"headerDescription": "<string>",
"pageMode": "compact",
"backgroundColor": "<string>",
"textColor": "<string>",
"buttonBackgroundColor": "<string>",
"buttonTextColor": "<string>",
"accentColor": "<string>",
"buttonBorderStyle": "full",
"inputBorderStyle": "full",
"headerImage": "<string>",
"logo": "<string>",
"fields": [
{
"id": "<string>",
"label": "<string>",
"description": "<string>",
"type": "<string>",
"subtype": "<string>",
"required": true,
"ratingCount": 123,
"options": [
{
"id": "<string>",
"value": "<string>"
}
],
"showDescription": true
}
],
"removeFormboxBranding": true,
"isClosed": true,
"orgId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}