# FormHug

> Build smart, beautiful forms for you and your audience.

## Docs

- [Authentication](https://formhug.ai/docs/api-reference/authentication.md): How to authenticate requests to the FormHug API — Personal Access Tokens and OAuth 2.0 PKCE access tokens.
- [Get an entry](https://formhug.ai/docs/api-reference/entries/get-an-entry.md): **Required scope:** `entry:read`.
- [List entries of a form](https://formhug.ai/docs/api-reference/entries/list-entries-of-a-form.md): Returns entries of a form owned by the current user, ordered by `serial_number` ascending, paginated by cursor.
- [Submit an entry](https://formhug.ai/docs/api-reference/entries/submit-an-entry.md): Create an entry on a form owned by the current user. Unknown field `api_code`s in `field_values` are dropped silently; missing required fields produce a validation error.
- [Create a folder](https://formhug.ai/docs/api-reference/folders/create-a-folder.md): Create a new folder at the root or under a parent folder.
- [Delete a folder](https://formhug.ai/docs/api-reference/folders/delete-a-folder.md): **Required scope:** `form:delete`.
- [List the current user folders](https://formhug.ai/docs/api-reference/folders/list-the-current-user-folders.md): Returns all folders owned by the current user, ordered by created_at desc. Not paginated.
- [Update a folder](https://formhug.ai/docs/api-reference/folders/update-a-folder.md): Currently only the name can be updated. Other fields such as parent_folder_token are ignored.
- [Get form settings](https://formhug.ai/docs/api-reference/form-settings/get-form-settings.md): **Required scope:** `form:read`.
- [Update form settings](https://formhug.ai/docs/api-reference/form-settings/update-form-settings.md): **Required scope:** `form:write`. Field-level merge within each group; null clears the corresponding feature.
- [Get the form theme](https://formhug.ai/docs/api-reference/form-themes/get-the-form-theme.md): **Required scope:** `form:read`.
- [Update the form theme](https://formhug.ai/docs/api-reference/form-themes/update-the-form-theme.md): **Required scope:** `form:write`. Partial-merge semantics — only keys present are written; explicit `null` clears.
- [Create a form](https://formhug.ai/docs/api-reference/forms/create-a-form.md): Create a blank form. Optionally supply initial fields, locale, timezone and a theme (via header_image_url or header_image_keywords). When `timezone` is omitted, the form defaults to `UTC`.
- [Delete a form](https://formhug.ai/docs/api-reference/forms/delete-a-form.md): **Required scope:** `form:delete`.
- [Get a form](https://formhug.ai/docs/api-reference/forms/get-a-form.md): **Required scope:** `form:read`.
- [List the current user forms](https://formhug.ai/docs/api-reference/forms/list-the-current-user-forms.md): Returns the current user forms, paginated by cursor. The default ordering is `created_at` descending; use the `sort` parameter to switch to another field.
- [Update a form](https://formhug.ai/docs/api-reference/forms/update-a-form.md): Update basic attributes, fields, locale, timezone, folder placement or theme. All body attributes are optional; only the provided ones are updated.
- [API Reference](https://formhug.ai/docs/api-reference/introduction.md): FormHug public REST API v1 — programmatically manage forms, entries, and webhooks.
- [Get current user info](https://formhug.ai/docs/api-reference/me/get-current-user-info.md): Returns info about the user associated with the access token, including their billing account and current subscription plan.
- [Form Field](https://formhug.ai/docs/api-reference/models/form-field.md): Discriminated union of all field types that can appear on a form. The concrete variant is selected by `type`.
- [Start an OAuth authorization request (PKCE)](https://formhug.ai/docs/api-reference/oauth/authorize.md): Start an OAuth 2.0 authorization request with PKCE (S256). The browser is redirected to the login page and ultimately back to the client `redirect_uri` with a `code` query parameter.
- [Revoke an access_token or refresh_token](https://formhug.ai/docs/api-reference/oauth/revoke.md): Revoke an access_token or refresh_token (RFC 7009). Returns 200 even when the token does not exist.
- [Exchange for access_token](https://formhug.ai/docs/api-reference/oauth/token.md): Exchange an authorization code or refresh token for an access_token. `client_id` + `client_secret` are required.
- [Submit an entry to a published form](https://formhug.ai/docs/api-reference/published-form-entries/submit-an-entry-to-a-published-form.md): Submit one entry to a published form as the authenticated user. Does not require ownership of the form, but the form must accept submissions (open, password validated, etc.).
- [Create a webhook integration](https://formhug.ai/docs/api-reference/webhooks/create-a-webhook-integration.md): **Required scope:** `integration:write`.
- [Delete a webhook integration](https://formhug.ai/docs/api-reference/webhooks/delete-a-webhook-integration.md): **Required scope:** `integration:write`.
- [Get a sample payload](https://formhug.ai/docs/api-reference/webhooks/get-a-sample-payload.md): Returns the payload shape that the webhook would deliver, useful for testing the receiver side.
- [List webhook integrations of a form](https://formhug.ai/docs/api-reference/webhooks/list-webhook-integrations-of-a-form.md): **Required scope:** `integration:read`.
- [Update a webhook integration](https://formhug.ai/docs/api-reference/webhooks/update-a-webhook-integration.md): **Required scope:** `integration:write`.
- [Manage Your Profile](https://formhug.ai/docs/features/account/profile.md): Update your FormHug profile, change your email or password, manage notification preferences, and review your account activity log.
- [Account Settings](https://formhug.ai/docs/features/account/workspace-settings.md): Manage your FormHug workspace plan, branding, integrations, usage logs, and third-party service connections from the Account Settings page.
- [AI Builder](https://formhug.ai/docs/features/building/ai-builder.md): Turn any idea into a complete form instantly — Evan, FormHug's AI agent, generates fields, descriptions, and visuals from a single sentence
- [End Page](https://formhug.ai/docs/features/building/end-page.md): Configure what submitters see after they submit — confirmation, quiz results, assessment reports, or a redirect
- [Field Attributes](https://formhug.ai/docs/features/building/field-attributes.md): Configure field settings and behavior
- [Advanced Fields](https://formhug.ai/docs/features/building/fields/advanced-fields.md): Powerful fields for complex data collection
- [Choice Fields](https://formhug.ai/docs/features/building/fields/choice-fields.md): Let submitters select from options
- [Contact Fields](https://formhug.ai/docs/features/building/fields/contact-fields.md): Collect contact information from submitters
- [Data Fields](https://formhug.ai/docs/features/building/fields/data-fields.md): Collect numbers, dates, times, and files
- [Display Fields](https://formhug.ai/docs/features/building/fields/display-fields.md): Add structure and information to your forms
- [Payment Fields](https://formhug.ai/docs/features/building/fields/payment-fields.md): Accept payments through your forms
- [Rating & Ranking Fields](https://formhug.ai/docs/features/building/fields/rating-fields.md): Collect ratings, rankings, and satisfaction scores
- [Text Fields](https://formhug.ai/docs/features/building/fields/text-fields.md): Collect text-based responses
- [Form Builder](https://formhug.ai/docs/features/building/form-builder.md): Build and customize your form using FormHug's 3-panel WYSIWYG editor with 30+ field types
- [Creating Forms](https://formhug.ai/docs/features/building/overview.md): Start a new form in FormHug using AI, a template, a blank canvas, or an Excel import
- [Form Submission Reports](https://formhug.ai/docs/features/data/reports.md): FormHug Reports automatically visualize your submission data with charts, completion rates, score distributions, and shareable public result pages.
- [Submissions](https://formhug.ai/docs/features/data/submissions.md): View, manage, and export your form responses — with a per-field overview panel and submission table
- [Assessment](https://formhug.ai/docs/features/scenes/assessment.md): Create personality tests and soft skill assessments with multi-dimension scoring, radar charts, and personalized result suggestions.
- [Booking](https://formhug.ai/docs/features/scenes/booking.md): Create calendar-based booking forms for appointments and reservations — with time slots, availability rules, and instant confirmations.
- [Public Query](https://formhug.ai/docs/features/scenes/public-query.md): Let participants look up their own scores, results, or status without contacting you — turn any form into a secure, self-service query page.
- [Quiz](https://formhug.ai/docs/features/scenes/quiz.md): Build engaging trivia, MCQs, and interactive quizzes with automatic scoring, instant results, score-based feedback, and shareable certificates
- [Basic Settings](https://formhug.ai/docs/features/settings/basic-settings.md): Control how your form is accessed, filled out, and when it accepts submissions
- [Collaborators](https://formhug.ai/docs/features/settings/collaborators.md): Invite team members to help manage your form and its submissions
- [Labels & Messages](https://formhug.ai/docs/features/settings/labels-messages.md): Customize the default button labels and system messages shown in your form
- [Submission Notifications](https://formhug.ai/docs/features/settings/notifications.md): Send automatic emails to form submitters when a new submission is created, using your Gmail account or an SMTP server.
- [Quiz & Assessment Settings](https://formhug.ai/docs/features/settings/quiz-settings.md): Configure time limits, random question pools, anti-cheating protections, and scoring rules for FormHug quizzes and assessments.
- [Submission Rules](https://formhug.ai/docs/features/settings/submission-rules.md): Control who can submit your form, how often, and what happens when limits are reached
- [Tracking & Pre-fill](https://formhug.ai/docs/features/settings/tracking-prefill.md): Create named tracking links per source and generate pre-fill links with field values already populated
- [Embed Options](https://formhug.ai/docs/features/sharing/embed.md): Add your FormHug form to any website as an inline iframe or a floating button
- [QR Code & Poster](https://formhug.ai/docs/features/sharing/qr-code.md): Generate QR codes and AI-designed posters for your forms to share them in physical spaces like events, retail, and print materials.
- [Share Link](https://formhug.ai/docs/features/sharing/share-link.md): Publish your form and share it via link, QR code, social media, AI poster, or source tracking links
- [Custom Branding](https://formhug.ai/docs/features/styling/custom-branding.md): Upload your logo and brand identity at the workspace level to apply across all your forms
- [Themes](https://formhug.ai/docs/features/styling/themes.md): Apply a preset theme or customize colors, header, and field styles in the FormHug theme panel
- [Embed in Framer](https://formhug.ai/docs/guides/embed/framer.md): Add a FormHug form to any Framer site using the Embed component — fully responsive across breakpoints, with no code required beyond pasting the snippet.
- [Embed in Notion](https://formhug.ai/docs/guides/embed/notion.md): Embed a FormHug form in any Notion page using the form link — visitors fill it out without leaving your Notion doc or shared workspace.
- [Embed in Webflow](https://formhug.ai/docs/guides/embed/webflow.md): Add a FormHug form to any Webflow page using the Embed element — responsive across all breakpoints and fully integrated into your Webflow layout.
- [Embed in WordPress](https://formhug.ai/docs/guides/embed/wordpress.md): Add a FormHug form to any WordPress page or post using the Custom HTML block or shortcode, with responsive sizing that works on any device.
- [Form Design Best Practices](https://formhug.ai/docs/guides/tips/best-practices.md): Essential form design tips to increase completion rates — from choosing the right field types and organizing questions to optimizing for mobile.
- [Build a Personality Assessment](https://formhug.ai/docs/guides/use-cases/assessment.md): Build a personality assessment that scores traits across custom dimensions and delivers a personalized radar chart report to every participant.
- [Create a Booking Form](https://formhug.ai/docs/guides/use-cases/booking-form.md): How to create an online booking form for appointments, classes, or venue rentals — with step-by-step setup guidance for each scenario.
- [Create a Contact Form](https://formhug.ai/docs/guides/use-cases/contact-form.md): How to create a contact form that captures visitor inquiries, routes messages to the right person, and sends automatic reply confirmations.
- [Send Emails to Form Submitters](https://formhug.ai/docs/guides/use-cases/gmail-email-notifications.md): How to connect Gmail to FormHug and send automatic confirmation emails and bulk reminders to form submitters.
- [Build an Interactive Quiz](https://formhug.ai/docs/guides/use-cases/quiz.md): Create an interactive quiz with automatic scoring and personalized results — ideal for audience engagement, lead generation, and social sharing.
- [Create a Registration Form](https://formhug.ai/docs/guides/use-cases/registration-form.md): How to build an online registration form — collect sign-ups, prevent duplicates, set capacity limits, and send automatic confirmation emails.
- [Build an Online Survey](https://formhug.ai/docs/guides/use-cases/survey.md): How to create an online survey that gets responses — pick the right question types, improve completion rates, and read results automatically.
- [FormHug Help Center](https://formhug.ai/docs/index.md): FormHug is an AI-powered form builder for registrations, surveys, bookings, quizzes, assessments, and more — beautiful by default, with Public Query, scoring, and MCP support.
- [Google Sheets Integration](https://formhug.ai/docs/integrations/google-sheets.md): Connect Google Sheets to FormHug and automatically send new form submissions to a spreadsheet
- [FormHug MCP Server](https://formhug.ai/docs/integrations/mcp.md): Connect Claude, Cursor, or any MCP-compatible AI assistant to FormHug and manage forms and submissions through natural language.
- [Billing & Payments](https://formhug.ai/docs/introduction/billing.md): Manage your FormHug subscription, update payment methods, download invoices, and cancel anytime from billing settings.
- [Create Your First Form](https://formhug.ai/docs/introduction/create-first-form.md): Four ways to start building a form in FormHug — from AI generation and templates to Excel import and building from scratch
- [Plans & Pricing](https://formhug.ai/docs/introduction/plans-pricing.md): Compare Free, Pro, and Business plans to find the right FormHug subscription for your needs, with monthly and yearly billing options.
- [Quick Start](https://formhug.ai/docs/introduction/quick-start.md): Get started with FormHug in 4 simple steps
- [Team Collaboration](https://formhug.ai/docs/introduction/team-collaboration.md): Invite team members to collaborate on forms, assign roles to control permissions, and manage access from a single place.
- [Welcome to FormHug](https://formhug.ai/docs/introduction/welcome.md): FormHug is an AI-powered form builder for registrations, surveys, bookings, quizzes, assessments, and more — beautiful by default, with Public Query and MCP support.
- [Who Is FormHug For](https://formhug.ai/docs/introduction/who-is-formhug-for.md): FormHug is built for creators, coaches, small teams, and educators who need beautiful, AI-powered forms for bookings, quizzes, registrations, and more.
- [Why Choose FormHug](https://formhug.ai/docs/introduction/why-formhug.md): Learn how FormHug compares to Typeform, Jotform, and other form builders, and why it's the smarter choice for modern forms.
- [Contact FormHug Support](https://formhug.ai/docs/resources/help/contact-support.md): Reach the FormHug team by email, in-app chat, or community Discord — and learn what to include for the fastest resolution.
- [Frequently Asked Questions](https://formhug.ai/docs/resources/help/faq.md): Get answers to common questions about FormHug plans, features, fields, embedding, data privacy, and team collaboration.
- [GDPR Compliance](https://formhug.ai/docs/resources/legal/gdpr.md): Learn how FormHug complies with the General Data Protection Regulation (GDPR) and how to build GDPR-compliant forms.
- [Privacy Policy](https://formhug.ai/docs/resources/legal/privacy-policy.md): FormHug Privacy Policy - How we collect, use, and protect your personal data.
- [Terms of Service](https://formhug.ai/docs/resources/legal/terms-of-service.md): FormHug Terms of Service - The legal agreement governing your use of the FormHug platform.
- [The FormHug Story](https://formhug.ai/docs/resources/team/about.md): Learn the story behind FormHug — why we built it, what the name means, and how forms became a bridge between human intent and AI action.
- [What Is FormHug](https://formhug.ai/docs/resources/team/overview.md): FormHug is an AI-powered form builder for registrations, surveys, bookings, quizzes, assessments, and more — beautiful by default and agent-ready via MCP.

## OpenAPI Specs

- [openapi](https://formhug.ai/docs/api-reference/openapi.yaml)