# Formfex Developer Documentation
> REST API, n8n Integration, Webhooks — Developer Reference for Formfex

Formfex is an AI-powered form platform with a full Public REST API, native n8n community node, and real-time webhooks. This documentation covers everything developers and AI agents need to integrate with Formfex programmatically.

## Public API

Base URL: https://api.formfex.com/api/v1/public

Authentication: Bearer token with API key (format: fxk_live_<keyId>.<secret>)

### Forms
- GET /forms — List all forms (paginated, searchable)
- GET /forms/:id — Get a single form with full schema
- POST /forms — Create a form with schema, fields, validation, conditional logic
- PATCH /forms/:id — Update form title or schema
- DELETE /forms/:id — Delete a form
- POST /forms/:id/publish — Publish a form (generates share URL)
- POST /forms/:id/unpublish — Unpublish a form
- POST /forms/:id/fields — Add a field to a form
- PATCH /forms/:id/fields/:fieldId — Update a field
- DELETE /forms/:id/fields/:fieldId — Delete a field

### Smart Forms (AI Interviews)
- GET /smart-forms — List smart forms
- GET /smart-forms/:id — Get a smart form
- POST /smart-forms — Create a smart form (AI generates questions from a purpose description)
- PATCH /smart-forms/:id — Update a smart form
- DELETE /smart-forms/:id — Delete a smart form
- POST /smart-forms/:id/publish — Publish a smart form
- POST /smart-forms/:id/unpublish — Unpublish a smart form
- GET /smart-forms/:id/sessions — List interview sessions
- GET /smart-forms/:id/sessions/:sessionId — Get session transcript
- POST /smart-forms/:id/chat — Analytics chat for smart form sessions
- POST /smart-forms/:id/analytics — Aggregate analytics
- GET /smart-forms/:id/export — Export sessions as CSV/JSON

### Responses
- GET /forms/:id/responses — List form responses (paginated)
- GET /forms/:id/responses/:responseId — Get a single response
- GET /forms/:id/responses/count — Count responses

### Analytics
- POST /forms/:id/smart-analytics — Trigger AI analytics report (async)
- POST /forms/:id/analytics-chat — Natural language Q&A about form data (supports SSE streaming)

### Account
- GET /me — Get account info

## API Key Scopes

| Scope | Access |
|-------|--------|
| FORMS_READ | List and read forms |
| FORMS_WRITE | Create, update, delete forms |
| RESPONSES_READ | Read form responses |
| WEBHOOKS_READ | List webhooks |
| WEBHOOKS_WRITE | Create, update, delete webhooks |
| AI_GENERATE | AI form generation |
| ANALYTICS_READ | Smart analytics and analytics chat |
| SMART_FORMS_READ | List and read smart forms |
| SMART_FORMS_WRITE | Create, update, delete smart forms |

## Rate Limits

| Plan | Per Minute | Per Hour | Monthly |
|------|-----------|----------|---------|
| Starter ($9/mo) | 20 | 200 | 2,000 |
| Pro ($29/mo) | 60 | 1,000 | 20,000 |
| Max ($120/mo) | 150 | 3,000 | 200,000 |

## Webhooks

Real-time HTTP POST notifications for form events with HMAC-SHA256 signing.

Events: FORM_RESPONSE_CREATED, FORM_PUBLISHED, FORM_UNPUBLISHED, FORM_CREATED, FORM_DELETED

Webhook API:
- GET /webhooks — List webhooks
- POST /webhooks — Create a webhook endpoint
- PATCH /webhooks/:id — Update a webhook
- DELETE /webhooks/:id — Delete a webhook

## n8n Integration

Native community node (n8n-nodes-formfex) for n8n workflow automation.

Nodes:
- Formfex (action node) — Form CRUD, responses, AI generation, analytics chat
- Formfex Trigger — Fires on new form responses

AI Agent Tool Mode: The node can be used as a LangChain tool inside n8n AI Agent workflows. AI agents can autonomously create forms, read responses, generate forms with AI, and analyze data.

5 AI Agent tools: create_form, get_responses, generate_form_with_ai, analyze_form_data, dispatch_smart_analytics

## Field Types

text, textarea, number, email, select, radio, checkbox, date, file

## Response Format

All responses: { "message": "...", "data": {...}, "error": null }

## Documentation Pages

- Welcome: https://docs.formfex.com/en/getting-started/welcome
- Authentication: https://docs.formfex.com/en/getting-started/authentication
- Rate Limits: https://docs.formfex.com/en/getting-started/rate-limits
- Error Reference: https://docs.formfex.com/en/getting-started/error-reference
- API Overview: https://docs.formfex.com/en/public-api/overview
- Create Form: https://docs.formfex.com/en/public-api/forms/create-form
- List Forms: https://docs.formfex.com/en/public-api/forms/list-forms
- Get Form: https://docs.formfex.com/en/public-api/forms/get-form
- Analytics Chat: https://docs.formfex.com/en/public-api/analytics/analytics-chat
- Smart Analytics: https://docs.formfex.com/en/public-api/analytics/smart-analytics
- Create Smart Form: https://docs.formfex.com/en/public-api/smart-forms/create-smart-form
- n8n Installation: https://docs.formfex.com/en/n8n/installation
- n8n AI Agent Tool: https://docs.formfex.com/en/n8n/ai-agent-tool
- n8n Operations: https://docs.formfex.com/en/n8n/operations
- Webhooks Overview: https://docs.formfex.com/en/webhooks/overview
- Webhook Events: https://docs.formfex.com/en/webhooks/events
- Webhook Security: https://docs.formfex.com/en/webhooks/security
- Full Reference: https://docs.formfex.com/llms-full.txt

## Links

- Formfex Homepage: https://formfex.com
- Developer Docs: https://docs.formfex.com
- Formfex Product Info: https://formfex.com/llms.txt