BionicForms REST API

Full programmatic access to forms, submissions, and analysis

The REST API gives you complete control over your BionicForms account. Create and manage forms, retrieve submissions, trigger analysis, and configure webhooks. Bearer token authentication, comprehensive error handling, and rate limiting are built in.

What You Get

Complete CRUD Operations

Create, read, update, and delete forms and submissions. Every action available in the UI is also available via the API.

Bearer Token Authentication

Generate API keys from your Settings page. Include the key as a Bearer token in the Authorization header. Keys can be revoked at any time.

Analysis Endpoints

Trigger AI analysis, check run status, and retrieve results (themes, sentiment, summaries) programmatically. Build analysis into your own dashboards.

Webhook Management

Create, update, and delete webhook configurations via the API. Automate your integration setup across multiple forms.

Rate Limiting

Generous rate limits with clear headers showing your remaining quota. Designed for production use, not just prototyping.

Comprehensive Error Handling

Consistent error response format with HTTP status codes, error codes, and human-readable messages. No guessing what went wrong.

How to Set Up REST API

Get connected in just a few minutes.

1

Generate an API Key

Go to Settings > API Keys in your BionicForms dashboard. Click 'Create API Key' and give it a descriptive name.

2

Copy the Key

Copy the API key immediately - it's only shown once. Store it securely in your application's environment variables.

3

Make Your First Request

Send a GET request to /api/v1/forms with your API key in the Authorization: Bearer header. You'll get a list of all your forms.

4

Explore the Documentation

The full API reference at /docs/api covers every endpoint with request/response examples, authentication details, and error codes.

Frequently Asked Questions

What authentication does the API use?
Bearer token authentication. Generate an API key from Settings > API Keys, then include it in the Authorization header as 'Bearer your-api-key' with every request.
What are the rate limits?
The API allows generous request rates for production use. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response so you can monitor your usage.
Can I trigger AI analysis via the API?
Yes. POST to the analysis endpoint for a form to start a new analysis run. You can poll the run status or use a webhook to be notified when it completes, then retrieve the full results.
Is the API available on all plans?
API access is available on all paid plans. The free tier does not include API access.
Where is the API documentation?
Full API documentation is available at bionicforms.com/docs/api. It covers authentication, all endpoints, request/response schemas, error codes, and code examples.
Can I use the API to build a custom form frontend?
Yes. Use the API to create forms and accept submissions programmatically. This lets you build entirely custom form UIs while using BionicForms for the backend, storage, and AI analysis.

Ready to Connect REST API?

Start free, no credit card required. Set up REST API in minutes.