Power Up Your Backend

Formeezy Submissions API

Use the Formeezy API to programmatically query and filter your form submission data. Create a key and start making requests in minutes.

Getting Started

API DOCS

Submit A Form

POST/v1/forms/{FORM_ID}/submissions

Using this submission API endpoint, you can send a POST request along with a payload to a specific form that will then be available in your Submissions Dashboard, as well as trigger any integrations. This endpoint does not require your X-API-KEY as it is the default public facing endpoint utilized to store submissions on your account.

Parameters

This endpoint does not accept any parameters.

Request

https://formeezy.com/api/v1/forms/{FORM_ID}/submissions
Get your free API key →

Request Body

{
    "email": "hello@example.com",
    "message": "Hi there! Just testing this form."
}

The form request body in FormData or JSON format.

Request Headers

X-API-Key

optional

Your unique key for making requests.

{'X-API-KEY': '{YOUR_API_KEY}'}

X-URL

optional

Manually add a referer source URL to your form submission.

{'X-URL': 'https://example.com/contact-us'}

Response Attributes

redirect

string

The redirect URL needed to complete next steps or continue to thank-you page. Possible URLs include Stripe Checkout, reCAPTCHA, default thank you page, and custom thank you page. This redirect be ignored if you are not using one-click reCAPTCHA or Stripe, and would prefer to manage success/error states manually.

Error Response Object

{
    "status": 404,
    "message": "Not Found: This form has been deleted, or does not exist. Please check your form URL.",
    "redirect" : "https://formeezy.com/app/error?status=400&message=This+is+an+error+message."
}

Error Response Attributes

status

number

The HTTP status code of the request.

message

string

The error message of the request.

redirect

number

The default error URL provided.

API DOCS

All Submissions

GET/v1/submissions

Using this submission API endpoint, you can return a list of submissions using various filters that are similar to the functionality available in your Formeezy submissions dashboard.

Parameters

page
Which page of results to return.

number - optional

per_page
The maximum number of results to be returned on each page, max 1000 and default 100.

number - optional

is_spam
Filter to include or exclude spam posts.

boolean - optional

query
Search your submissions for specific words.

string - optional

Request

https://formeezy.com/api/v1/submissions
Get your free API key →

Request Headers

X-API-Key

required

Your unique key for making requests.

{'X-API-KEY': '{YOUR_API_KEY}'}

Response Attributes

submissions

array

Array of submissions matching this query.

id

string

The ID of the submission.

created_at

date

The date this submission was created.

is_spam

boolean

The current spam status of this submission.

is_read

boolean

The current read/unread status.

form_id

string

The ID of the form this submission was sent to.

body

object

The body of your form submission.

total_submissions

number

The total number of submissions for this search.

per_page

number

The number of results per page.

page

number

The current page of results.

total_pages

number

The number of pages total for this query.

more_results

boolean

Whether there are more results or not.

API DOCS

Submissions By Form

GET/v1/forms/{FORM_ID}/submissions

Using this submission API endpoint, you can return a list of submissions for a specific form using various filters that are similar to the functionality available in your Formeezy forms dashboard.

Parameters

page
Which page of results to return.

number - optional

per_page
The maximum number of results to be returned on each page, max 1000 and default 100.

number - optional

is_spam
Filter to include or exclude spam posts.

boolean - optional

query
Search your submissions for specific words.

string - optional

Request

https://formeezy.com/api/v1/forms/{FORM_ID}/submissions
Get your free API key →

Request Headers

X-API-Key

required

Your unique key for making requests.

{'X-API-KEY': '{YOUR_API_KEY}'}

Response Attributes

submissions

array

Array of submissions matching this query.

id

string

The ID of the submission.

created_at

date

The date this submission was created.

is_spam

boolean

The current spam status of this submission.

is_read

boolean

The current read/unread status.

form_id

string

The ID of the form this submission was sent to.

body

object

The body of your form submission.

total_submissions

number

The total number of submissions for this search.

per_page

number

The number of results per page.

page

number

The current page of results.

total_pages

number

The number of pages total for this query.

more_results

boolean

Whether there are more results or not.

API DOCS

Submission By ID

GET/v1/submissions/{SUBMISSION_ID}

Using this submission API endpoint, you can return a list of submissions using various filters that are similar to the functionality available in your Formeezy submissions dashboard.

Parameters

This endpoint does not accept any parameters.

Request

https://formeezy.com/api/v1/submissions/{SUBMISSION_ID}
Get your free API key →

Request Headers

X-API-Key

required

Your unique key for making requests.

{'X-API-KEY': '{YOUR_API_KEY}'}

Response Attributes

id

string

The ID of the submission.

created_at

date

The date this submission was created.

is_spam

boolean

The current spam status of this submission.

is_read

boolean

The current read/unread status.

form_id

string

The ID of the form this submission was sent to.

body

object

The body of your form submission.

Was this helpful?