Skip to content

The FormsAI REST API

Read forms and responses, create forms and subscribe webhooks from your own code, with an API key and JSON.

Written by
Updated

FormsAI Pro
On this page

The API lives at https://app.formsai.dev/api/v1. Every request is authenticated with an API key and returns JSON. Field names are snake_case.

Shell
curl https://app.formsai.dev/api/v1/forms \
  -H "Authorization: Bearer fk_live_…"

Endpoints

Method and pathWhat it does
GET /meThe account the key belongs to.
GET /formsYour forms. See forms.
POST /formsCreate a form.
GET /forms/:idOne form, with its full form document.
GET /forms/:id/responsesCompleted responses, newest first, paginated. See responses.
GET /forms/:id/responses/:ridOne response, with Filo's follow-ups.
DELETE /forms/:id/responses/:ridDelete a response and its files.
GET /forms/:id/webhooksA form's webhooks. See webhook endpoints.
POST /forms/:id/webhooksSubscribe a webhook.
DELETE /forms/:id/webhooks/:widUnsubscribe it.

OpenAPI

The full description is at https://app.formsai.dev/api/v1/openapi.json (OpenAPI 3.1). Import it into Postman, Insomnia or a code generator.