Base URL

Authentication

Response Codes

Caveats

Formbox API Reference - Introduction

Introduction

Formbox Docs

Welcome to the Formbox documentation site. Formbox is a powerfull forms backend for you HTML forms. It allows you to collect submissions from your forms without any backend code. You can get email notifications for new submissions, upload files from your forms, and even integrate with services like Google Sheets, Slack, and more. This documentation will guide you through the process of setting up and managing your forms with Formbox.

Formbox offers a wide range off features to help you manage your forms and submissions. Familiarize yourself with Formbox's features with our comprehensive set of guides.

Features overview

Looking for a way to organize your Formbox forms based on a company or client? Organizations lets you group your forms, invite team members, and manage access rights for every organization.

Organizations

With self email notifications, you will receive an email each time there is a new successful submittion to your form.

Self email notifications

Respondent email notifications will send an email to the person who submits your form. It’s the same thing as Auto-Responses.

Respondent email notifications

Send auto-response emails from your custom email domain using SMTP

SMTP custom email domain

Direct users to a custom URL after successful submissions.

Custom redirects

Customize the thank you page after successful submissions.

Customize thank you page

Formbox offers a variety of spam filtering options you can add to your forms to ensure only legitimate submissions are sent to your inbox.

Spam protection

Setup your forms to block form submissions from a specific IP address.

IP address blacklist

Setup your forms to only accept form submissions from a specific domain and all it's subdomains.

Domain restrictions

Setup your forms to only accept form submissions from specific countries.

Country restrictions

In case you need to do something with your form submissions data, Formbox allows you to export your submissions in CSV or JSON file formats.

Exporting submissions

Learn how to use AJAX with the **fetch** API in your handle submissions on your form.

AJAX support

Store, download, and share files collected with your Formbox forms.

File Uploads

Learn how to integrate your Formbox form with <a href="https://react.dev" target="_blank" rel="noopener noreferrer">React</a>.

React

Learn how to integrate your Formbox form with <a href="https://vuejs.org" target="_blank" rel="noopener noreferrer">Vue</a>.

Learn how to integrate your Formbox form with <a href="https://nextjs.org" target="_blank" rel="noopener noreferrer">Next</a>.

Nuxt

Learn how to integrate your Formbox form with <a href="https://svelte.dev/" target="_blank" rel="noopener noreferrer">Svelte</a>.

Svelte

Learn how to integrate your Formbox form with <a href="https://remix.run" target="_blank" rel="noopener noreferrer">Remix</a>.

Remix

Learn how to integrate your Formbox form with <a href="https://astro.build" target="_blank" rel="noopener noreferrer">Astro</a>.

Astro

Learn how to integrate your Formbox form with <a href="https://angular.io" target="_blank" rel="noopener noreferrer">Angular</a>.

Angular

Learn how to integrate your Formbox form with <a href="https://webflow.com" target="_blank" rel="noopener noreferrer">Webflow</a>.

Webflow

Formbox offers a wide range of direct integrations to help you streamline your processes and save time.

Integrations overview

With the Google Sheets integration, you can send your Formbox form submissions straight to a Google Sheet. This is a great way to manage and share your form results with your team and create visual reports of your data.

Goolgle Sheets

With the Airtable integration, you can send your Formbox form submissions straight to a an Airtable database. This is a great way to manage and share your form results with your team and create visual reports of your data.

Airtable

If you only need to forward submission data to your app or service, then a custom webhook is a great solution. Formbox supports settiing up webhooks for your forms This instant notification lets you build automated workflows to take action on form entries.

Webhooks

With the Mailchimp integration, you can add your form submissions to your Mailchimp audience list. This is a great way to grow your email list with the leads you collect from your forms.

Mailchimp

With the Slack integration, you can get notified in a Slack channel when a form submission is received.

Slack

Notion

Zapier can help you automate tasks and build workflows between thousands of different apps through automated connections called Zaps. You can set them up in minutes with no coding.

Zapier

How to get my Formbox API key?

API Keys

What are Formbox's API rate limits?

Rate limits

Troubleshoot problems with this comprehensive breakdown of all error codes.

Formbox API returns machine readable error codes, human readable error messages.

Errors

Retrieve a paginated list of forms for the authenticated organization.

Get list of forms associated with your organization with the Formbox API - API Reference

Retrieve a list of forms

Create a new form for the authenticated organization.

Create a new form with the Formbox API - API Reference

Create a new form

Retrieve a specific form for the authenticated organization.

Get a form with the Formbox API - API Reference

Retrieve a form

Update a form for the authenticated organization.

Update a form with the Formbox API - API Reference

Update a form

Delete a specific form for the authenticated organization.

Delete a form with the Formbox API - API Reference

Delete a form

Retrieve a paginated list of submissions for a given form for the authenticated organization.

Get list of submissions associated with a form with the Formbox API - API Reference

Retrieve a list of submissions

Retrieve a specific submission for a given form for the authenticated organization.

Get a submission with the Formbox API - API Reference

Retrieve a submission

Delete a specific submission for a given form for the authenticated organization.

Code	Description
`200`	The request was successful.
`400`	The request was invalid or cannot be served.
`401`	The request requires user authentication.
`403`	The server understood the request, but refuses to authorize it.
`404`	The requested resource could not be found.
`429`	Too many requests.
`500`	The server encountered an unexpected condition which prevented it from fulfilling the request.

API Reference

Forms

Submissions

Introduction

Base URL

Authentication

Response Codes

Caveats

API Reference

Forms

Submissions

​Base URL

​Authentication

​Response Codes

​Caveats

Base URL

Authentication

Response Codes

Caveats