Skip to main content
POST
Create a form

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required
Maximum string length: 128
Example:

"Contact form"

active
boolean

Inactive forms reject submissions.

folder_id
string | null

The folder the form is filed in. null for no folder.

storage
object
spam
object
self_email_notification
object

The email you get on every submission.

auto_response
object

The email the person who submitted receives.

after_submit
object

What the visitor sees after submitting.

validation
object

Rules a submission must pass.

team_id
string

Team that owns the new form. Required when the credential covers several teams (OAuth connections).

Example:

"64b000000000000000000001"

Response

id
string
required
read-only
Example:

"AbC123xyz"

team_id
string
required
read-only
name
string
required
Example:

"Contact form"

endpoint
string
required
read-only

Where your HTML form posts.

Example:

"https://formcarry.com/s/AbC123xyz"

active
boolean
required

Inactive forms reject submissions.

avatar
string
required
read-only
Example:

"🚀"

folder_id
string | null
required

The folder the form is filed in, or null for none.

created_at
string
required
read-only
Example:

"2026-01-15T10:00:00.000Z"

last_submission_at
string | null
required
read-only

When the newest submission arrived, or null before the first.

submissions
object
required
storage
object
required
spam
object
required
self_email_notification
object
required
auto_response
object
required
after_submit
object
required
webhooks
object[]
required
read-only

Managed at /v1/forms/{form_id}/webhooks; one per form for now.

validation
object
required