Skip to main content
PATCH
Update a form

Authorizations

Authorization
string
header
required

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

Path Parameters

form_id
string
required

The form's id, as shown in the dashboard and in the form's endpoint URL

Body

application/json
name
string
Maximum string length: 128
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.

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