Forms

List, create, view, and delete forms through the FormBackend API

Use the forms endpoints to manage form endpoints on your account. Authenticate with an API key.

There is no update endpoint. Change settings in the dashboard, or use the MCP server tools when working from an AI assistant.

Endpoints

Action	Method	URL
List forms	GET	/api/v1/forms
Create a form	POST	/api/v1/forms
View a form	GET	/api/v1/forms/:identifier
Delete a form	DELETE	/api/v1/forms/:identifier

:identifier is the form token (the value in /f/{token} URLs).

List forms

curl -H 'Authorization: Bearer exampletoken' \
  https://www.formbackend.com/api/v1/forms

{
  "forms": [
    {
      "id": 1,
      "name": "My test form",
      "identifier": "2fc637ed03b374c5",
      "submission_count": 4
    }
  ]
}

Create a form

curl -H 'Authorization: Bearer exampletoken' \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{"form": {"name": "My form"}}' \
  https://www.formbackend.com/api/v1/forms

Common create attributes include name, submission_text, redirect_url, notification fields (notify_owner_on_submission, notify_owner_emails, submitter notification fields), thank-you page colors, domains (whitelisted domains), and webhook_url.

On unpaid accounts, paid-only attributes such as redirect_url and notify_owner_emails are ignored even if you send them.

webhook_url is the legacy single-webhook field. Prefer managing modern webhook endpoints from the form Integrations tab — see Webhooks.

View a form

curl -H 'Authorization: Bearer exampletoken' \
  https://www.formbackend.com/api/v1/forms/uniquetoken

{
  "id": 1,
  "name": "Contact form",
  "identifier": "2fc637ed03b374c5",
  "submission_text": "Thank you for your submission",
  "webhook_url": null,
  "redirect_url": null,
  "notify_submitter": null,
  "notify_submitter_from": null,
  "notify_submitter_from_name": null,
  "notify_submitter_subject": null,
  "notify_submitter_body": null,
  "notify_owner_on_submission": false,
  "notify_owner_emails": null,
  "show_submitted_values": false,
  "bg_color": null,
  "text_color": null,
  "link_color": null,
  "whitelisted_domains": null,
  "submission_count": 4
}

Delete a form

curl -H 'Authorization: Bearer exampletoken' \
  -X DELETE \
  https://www.formbackend.com/api/v1/forms/uniquetoken

Deleting a form removes it and its submissions. Prefer disabling a form in the dashboard when you only need to stop new submissions temporarily.