Public API
Programmatic access to feedback, roadmap, CRM, changelog, and webhooks.
Interactive API reference
Full endpoint details, request/response schemas, and try-it-out support are auto-generated from our OpenAPI spec.
Base URL
https://app.feedback1.ai/api/v1Authentication
All requests require a workspace API key in the Authorization header:
Authorization: Bearer <api_key>Create and manage keys in Settings → API Keys. You can create multiple keys per workspace (e.g. for Zapier, CI/CD, or MCP).
Production keys use the format f1_live_<random>.
Resources
RESTful endpoints grouped by area:
Product-scoped
/products/{product_id}/feedback— customer feedback/products/{product_id}/features— roadmap features/products/{product_id}/changelog— release notes/products/{product_id}/roadmap— public roadmap
CRM (tenant-wide)
/accounts,/accounts/{id}/contacts,/accounts/{id}/deals/contacts,/deals
Management
/products— list products/api-keys— manage API keys/webhooks— configure outbound webhooks
See the interactive docs for full endpoint lists, filters, and schemas.
Pagination & filtering
List endpoints support standard query parameters:
page,page_size(max 100)sort_by,sort_order(asc/desc)created_after,created_before,updated_after
Responses include items, total, and pagination metadata.
Rate limits
Limits are enforced per API key and vary by plan (14-day trial uses Startup limits):
| Plan | Requests / hour | Requests / day |
|---|---|---|
| Startup | 1,000 | 10,000 |
| Business | 10,000 | 100,000 |
| Enterprise | Custom | Custom |
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Exceeding limits returns 429 Too Many Requests.
Webhooks
Subscribe to Feedback1 events (e.g. new feedback, feature updates) via outbound webhooks. Manage subscriptions with the /webhooks endpoints — create, update, test, and delete webhook configurations.
Payload format, event types, and signature verification are documented in the Swagger UI.
AI assistants
For Claude Desktop, Cursor, and other MCP clients, use the MCP integration instead of calling REST endpoints directly. MCP exposes search, stats, and CRM tools.
Support
Questions about the API? Email support@feedback1.ai.
