> ## Documentation Index
> Fetch the complete documentation index at: https://formcarry.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy Forms API — Create and Delete Forms

> Use the legacy Formcarry Forms API to programmatically create forms with configuration options, or permanently delete forms by ID.

<Warning>
  This page documents the **legacy** Forms API at `formcarry.com/api`. For new integrations, use the [v1 Forms endpoints](/docs/api/overview) at `api.formcarry.com`.
</Warning>

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

```text theme={null}
PUT https://formcarry.com/api/form
```

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

### Headers

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

### Body

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

```json theme={null}
{
  "title": "Contact Form"
}
```

### Example

```bash theme={null}
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 a form

```text theme={null}
DELETE https://formcarry.com/api/form/{formId}
```

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

### Path parameters

* `formId` — The unique ID of the form to delete.

### Example

```bash theme={null}
curl -X DELETE https://formcarry.com/api/form/YOUR_FORM_ID \
  -H "api_key: YOUR_API_KEY"
```


## Related topics

- [Legacy Formcarry API Overview](/docs/api/legacy/overview.md)
- [API Authentication with Bearer Tokens](/docs/api/authentication.md)
- [Delete a form](/docs/api-reference/forms/delete-a-form.md)
- [Formcarry API Overview](/docs/api/overview.md)
- [Delete a webhook](/docs/api-reference/forms/delete-a-webhook.md)