canonical: https://jentic.com/apis/formbuilder.com/formbuilder

# FormBuilder API

The FormBuilder API creates, publishes, and reads forms, and can bootstrap an account and API key in a single signup call so no browser is needed. It lists form responses, downloads attachment files, and registers webhooks for new responses, and it offers an agent-oriented endpoint set for drafting, validating, and publishing forms with a safety review. Responses can be queried for only the records a token is authorized to read.

## For AI agents

Create and publish forms, list and retrieve responses, and register webhooks for new submissions. Draft, validate, and publish forms through a dedicated agent endpoint set, and bootstrap an account and API key in one call.

## Scope

Does not send email campaigns, process payments, or build landing pages. Use for creating forms, collecting responses, and managing response webhooks only.

## Capabilities

- Create an account and API key in a single signup call, no browser required
- Create forms and optionally publish them in the same request
- List a form's responses newest-first and retrieve a single authorized response
- Download the committed file attachments on a response
- Register, list, and delete webhooks that fire on new responses
- Draft, validate, publish, and unpublish forms through the agent endpoint set
- Query a form for only the responses a token is eligible to read

## Use cases

### Agent Form Lifecycle

An AI agent connected through Jentic can sign up for an account, create a form, publish it after a safety review, and then read the responses it collects, without a developer wiring the FormBuilder API by hand. The agent uses the dedicated agent endpoints to draft and validate structure before publishing.

Example prompt: Sign up for an account, create and publish a feedback form, then list the first page of responses

### Response Collection and Webhooks

Applications pull form responses and react to new submissions in real time. FormBuilder lists responses newest-first, retrieves a single authorized response, and registers webhooks so a backend is notified the moment a response arrives.

Example prompt: Register a webhook for new responses on a form and list the most recent responses

### Attachment Handling

Forms that accept file uploads need a way to retrieve the uploaded bytes. FormBuilder lists the committed private attachments on a response and downloads the original attachment file for processing or archival.

Example prompt: List the files attached to a specific response and download the original attachment bytes

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v1/signup` | Create an account and API key in one call |
| POST | `/api/v1/forms` | Create a form, optionally publishing it |
| GET | `/api/v1/forms/{formId}/responses` | List responses for a form, newest first |
| POST | `/api/v1/hooks` | Register a webhook for new responses |
| POST | `/api/v1/agent/forms` | Create an idempotent private draft |
| POST | `/api/v1/agent/forms/{formId}/publish` | Publish a form with safety review |
| GET | `/api/v1/forms/{formId}/responses/{responseId}` | Retrieve one authorized response |

## Key resources

- **Forms** — Create, list, and publish forms and inspect a form's field schema
- **Responses** — List responses newest-first, retrieve a single response, and query eligible responses
- **Attachments** — List committed private attachments on a response and download the original file
- **Webhooks** — Register, list, and delete webhooks for new responses
- **Agent operations** — Draft, validate, publish, and unpublish forms through the agent endpoint set
- **Account** — Create an account and API key and validate the current key

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 56 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 31 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 74 / 100
- **View full report:** https://jentic.com/apis/formbuilder.com/formbuilder/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the FormBuilder API by hand means creating a personal access token, learning its separate agent endpoint set, and handling the safety-review publish step yourself. Through Jentic you install once, import FormBuilder from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** FormBuilder carries the form id in the URL path, so a rule can pin your agent to one form and the operations you pick, such as reading responses and listing hooks. You choose the operations it may call, so actions like publishing, unpublishing, or deleting a webhook are not included unless you add them.
- **Credential handling:** Your FormBuilder token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a form' or 'list form responses', and Jentic returns the matching FormBuilder operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Typeform** — Conversational form and survey builder with a hosted response store.
- **Jotform** — Form builder with a large template library and submission management.
- **123FormBuilder** — Drag-and-drop form builder with submissions and integrations.
- **Mailchimp** — Email marketing platform that can act on form responses.

## FAQ

### What authentication does the FormBuilder API use?

The FormBuilder API authenticates with a personal access token sent as a bearer token in the Authorization header, per its OpenAPI spec. You can create a token in the developer portal or bootstrap an account and token through the signup operation without a browser. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time.

### Can I publish a form with the FormBuilder API?

Yes. You can publish a form directly when you create it, or use the agent publish operation, which runs a safety review before the form goes live and begins accepting submissions.

### Can I limit what my agent is allowed to do with the FormBuilder API?

Yes. Since the form id sits in the URL path, write a rule that pins the agent to one form and allows only the response-reading operations, so it can pull submissions without publishing, unpublishing, or deleting a webhook. Every call it makes is logged.

### Is there a FormBuilder MCP server?

You do not need an MCP server to give your agent the FormBuilder API. Jentic connects it directly from the API Directory: import FormBuilder, store your token once, and the agent calls its operations by intent without loading another server's tool definitions into its context.

### What are the rate limits for the FormBuilder API?

The OpenAPI spec does not specify numeric rate limits for the FormBuilder API. Check the FormBuilder documentation at https://formbuilder.com for current limits.

### How do I create a form with the FormBuilder API through Jentic?

Search Jentic for an intent like 'create a form', and it returns FormBuilder's form-creation operation with its input schema so your agent can define fields and publish in one call. To run it on your own infrastructure, install Jentic One from its GitHub repo.