Legacy Forms API — Create and Delete Forms

This page documents the legacy Forms API at formcarry.com/api. For new integrations, use the v1 Forms endpoints at api.formcarry.com.

The legacy Forms API lets you create a new form or delete an existing one. All requests use the api_key header for authentication.

Create a form

PUT https://formcarry.com/api/form

Creates a new form on your account. Pass the form’s configuration in the JSON body.

Header	Value
`api_key`	Your Formcarry API key
`Content-Type`	`application/json`

Send a JSON object with your form’s title and any optional configuration (thank-you page, custom redirect, spam protection settings, etc.).

{
  "title": "Contact Form"
}

curl -X PUT https://formcarry.com/api/form \
  -H "api_key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Contact Form"}'

The response contains the new form’s ID, which you use as the endpoint for submissions.

DELETE https://formcarry.com/api/form/{formId}

Permanently deletes a form and all of its submissions. This action cannot be undone.

curl -X DELETE https://formcarry.com/api/form/YOUR_FORM_ID \
  -H "api_key: YOUR_API_KEY"

⌘I