FormDrop LogoFormDropGet Started

API Reference

Programmatic access to FormDrop features.

Authentication

FormDrop uses API keys for authentication to the Management API. You can find your API keys in the dashboard settings.

Important: Keep your Private API Key secret. It allows full access to your forms and submissions. Never expose this in client-side code.

Authenticate your requests by including your API key in the Authorization header:

http
Authorization: Bearer YOUR_PRIVATE_KEY
POST

Submit Form

Send a new form submission. This endpoint is public and should be used from your frontend code.

Endpoint

https://api.formdrop.io/f/:formSlug

Request Body

A JSON object containing your form fields.

javascript
// Example using fetch
fetch('https://api.formdrop.io/f/my-form-slug', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: "user@example.com",
    message: "Hello world"
  })
})
GET

List Forms

Retrieve a list of all your forms. Requires a private API key.

bash
curl https://api.formdrop.io/forms \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY"
GET

Get Submissions

Retrieve submissions for a specific form. Requires a private API key.

bash
curl https://api.formdrop.io/:formId/submissions \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY"
DELETE

Delete Submission

Permanently delete a specific submission. Requires a private API key.

bash
curl -X DELETE https://api.formdrop.io/:formId/submissions/:submissionId \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY"