/form

post https://www.formstack.com/api/v2/form.json

Create a new form in your account

POST /api/v2/form.json HTTP/1.1
Host: www.formstack.com
Authorization: Bearer [[app:oauth_token]]
Accept: application/json
Content-Type: application/json

name=Test%20Form&submit_button_title=Save%20Form&use_ssl=1

curl -X POST -i -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer [[app:oauth_token]]" -d "name=Test%20Form&submit_button_title=Save%20Form&use_ssl=1" https://www.formstack.com/api/v2/form.json

Body Params

name

string

required

The form name

boolean

Defaults to false

Flag to disable or enable submissions to be saved in our database

template

string

Template ID for the template you want to use

num_columns

int32

Number (1-4) of columns the form layout will have

label_position

string

Defaults to top

Sets the default field label position. Possible values are: "top" or "left"

submit_button_title

string

Defaults to Submit Form

Sets the submit button title

password

string

Sets a password for the form

use_ssl

boolean

Defaults to false

Flag to disable or enable SSL (only available on accounts that have security features)

timezone

string

Defaults to US/Eastern

Sets the timezone for the form

language

string

Defaults to en

Sets the language for the form - use ISO 639-1 language codes

active

boolean

Defaults to false

Flag to make the form active/inactive

disabled_message

string

The message to show when the form is inactive

fields

array of strings

Array of Field resources

fields

notifications

array of strings

Array of Notification Email resources

notifications

confirmation

array of strings

Array of Confirmation Email resources

confirmation

webhooks

string

Array of Webhook resources

Responses

Language

Credentials

OAuth2


xxxxxxxxxx
15
1
curl --request POST \
2
     --url https://www.formstack.com/api/v2/form.json \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "db": false,
8
  "label_position": "top",
9
  "submit_button_title": "Submit Form",
10
  "use_ssl": false,
11
  "timezone": "US/Eastern",
12
  "language": "en",
13
  "active": false
14
}
15
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201201

400400

403403

500500