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

# Formasty Forms API

The Formasty Forms API builds and publishes multi-step forms, letting you draft a form, add steps and fields, set conditional logic, configure quiz scoring, and publish once the draft validates. It reads and creates submissions, manages thank-you screens and design, and inspects the capabilities granted to the authenticated credential. Forms are edited as drafts and promoted to a published version through a validate-then-publish flow.

## For AI agents

Draft multi-step forms, add steps, fields, and conditional logic, then validate and publish them. Read and create submissions, and configure quiz scoring, design, and thank-you screens.

## Scope

Does not send email or SMS notifications, process payments, or host a landing page. Use for building, publishing, and collecting responses from Formasty forms only.

## Capabilities

- Create a form draft and save its complete structure in one call
- Add, reorder, update, and remove steps and fields within a draft
- Set conditional logic on a step and configure quiz result rules
- Validate a draft and publish it once it passes
- List, create, and retrieve form submissions
- Customize draft design and additional thank-you screens
- Inspect the capabilities and scopes of the authenticated credential

## Use cases

### Agent-Built Forms

An AI agent connected through Jentic can draft a complete form, add its steps and fields, validate the structure, and publish it without a developer touching the Formasty API directly. The agent finds each operation by intent and calls it with a stored OAuth token or API key.

Example prompt: Create a two-step contact form with name and email fields, validate the draft, and publish it

### Dynamic Survey Logic

Teams build surveys whose questions branch on previous answers. Formasty attaches conditional logic to a step and configures quiz result rules, so a published survey can route respondents and score their answers automatically.

Example prompt: Add a step, attach logic that shows it only when a prior answer is yes, and configure quiz scoring

### Submission Collection

Applications collect and read structured responses from published forms. Formasty lists submissions for a form and returns a single submission, so a backend can pull new responses and act on them.

Example prompt: List the submissions for a published form and retrieve the most recent one

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/forms` | Create a form draft |
| PUT | `/forms/{form_id}/draft` | Save the complete form draft |
| POST | `/forms/{form_id}/validate` | Validate a form draft |
| POST | `/forms/{form_id}/publish` | Publish a form |
| GET | `/forms/{form_id}/submissions` | List form submissions |
| POST | `/forms/{form_id}/submissions` | Create a submission |
| GET | `/capabilities` | Inspect effective API capabilities |

## Key resources

- **Forms** — Create, list, update, and delete form drafts and get a single form
- **Steps and fields** — Create, reorder, update, and remove steps and fields within a draft
- **Logic and quiz** — Replace step logic and configure quiz result rules
- **Submissions** — List, create, and retrieve form submissions
- **Design and screens** — Update draft design and manage additional thank-you screens

## 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:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 76 / 100
  - Developer Experience & Jentic Compatibility: 64 / 100
  - AI-Readiness & Agent Experience: 48 / 100
  - Agent Usability: 94 / 100
  - Security: 75 / 100
  - AI Discoverability: 78 / 100
- **View full report:** https://jentic.com/apis/formasty.com/formasty/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 Formasty Forms API by hand means implementing its OAuth 2.0 authorization-code flow with PKCE or managing an API key, and sequencing the validate-then-publish steps yourself. Through Jentic you install once, import Formasty from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** Formasty 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 editing the draft and reading submissions. You choose the operations it may call, so destructive ones like deleting a form or a field are not included unless you add them.
- **Credential handling:** Your Formasty credential 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 'read submissions', and Jentic returns the matching Formasty 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.
- **Tally** — Lightweight form builder with simple creation and response retrieval.
- **Mailchimp** — Email marketing platform that can act on form submissions.

## FAQ

### What authentication does the Formasty Forms API use?

The Formasty Forms API accepts two credentials per its OpenAPI spec: an OAuth 2.0 authorization-code flow with PKCE and refresh tokens, and an account-owned API key sent as a bearer token. Scopes such as reading, creating, and publishing forms are granted per credential. Through Jentic the credential is stored encrypted by your own Jentic One instance and injected at call time.

### Can I publish a form with the Formasty Forms API?

Yes. Formasty publishes a form through a validate-then-publish flow: you validate the draft, and once it passes, the publish operation promotes the draft to a live version that accepts submissions.

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

Yes. Because the form id travels in the URL path, write a rule that pins the agent to one form and allows only the draft-editing and validate operations, so it can build and check a form without publishing it or deleting anything. Every call it makes is logged.

### Is there a Formasty MCP server?

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

### What are the rate limits for the Formasty Forms API?

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

### How do I publish a form with the Formasty Forms API through Jentic?

Search Jentic for an intent like 'publish a form', and it returns Formasty's validate and publish operations with their input schemas so your agent can draft, validate, and publish in sequence. To run it on your own infrastructure, install Jentic One from its GitHub repo.